Zustand überwachen

Gemini Enterprise Agent Platform Workbench-Instanzen bieten mehrere Methoden zum Monitoring des Zustands Ihrer Notebooks. Auf dieser Seite wird die Verwendung der einzelnen Methoden beschrieben.

Methoden zur Überwachung des Systemstatus

Sie haben mehrere Möglichkeiten, den Zustand Ihrer Agent Platform Workbench-Instanzen zu überwachen. Auf dieser Seite wird die Verwendung der folgenden Methoden beschrieben:

• Gastattribute verwenden, um den Systemzustand zu melden

• Benutzerdefinierte Messwerte an Cloud Monitoring melden

• System- und Anwendungsmesswerte an Monitoring melden, indem Sie Monitoring auf einer Agent Platform Workbench-Instanz installieren

• Diagnosetool verwenden

Hinweis

1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

   Go to project selector

2. Verify that billing is enabled for your Cloud de Confiance project.

3. Enable the Notebooks API, if it is not already enabled.

   Roles required to enable APIs

   To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

   Enable the API

4. Install the Google Cloud CLI.

5. Configure the gcloud CLI to use your federated identity.

   For more information, see Sign in to the gcloud CLI with your federated identity.

6. To initialize the gcloud CLI, run the following command:

   gcloud init

Gastattribute verwenden, um den Systemzustand zu melden

Sie können Gastattribute verwenden, um den Systemzustand der folgenden Hauptdienste zu melden:

• Docker-Dienst
• Docker-Reverse-Proxy-Agent
• Jupyter-Dienst
• Jupyter API

Gastattribute sind ein spezieller Typ benutzerdefinierter Metadaten, in den Anwendungen schreiben können, während sie auf Ihrer Agent Platform Workbench-Instanz ausgeführt werden. Weitere Informationen zu Gastattributen finden Sie unter VM-Metadaten.

Wie Instanzen Gastattribute verwenden, um den Systemzustand zu melden

Der notebooks-collection-agent-Dienst führt einen Python-Prozess im Hintergrund aus, der den Status der Hauptdienste der Agent Platform Workbench-Instanz prüft und die Gastattribute als 1 aktualisiert, wenn keine Probleme erkannt werden, oder als -1, wenn ein Fehler erkannt wird.

Wenn Sie den Dienst notebooks-collection-agent verwenden möchten, um Berichte zum Zustand Ihrer Agent Platform Workbench-Instanz zu erstellen, müssen Sie die folgenden Gastattribute bei der Erstellung einer Agent Platform Workbench-Instanz aktivieren:

• enable-guest-attributes=TRUE: Aktiviert Gastattribute auf Ihrer Agent Platform Workbench-Instanz. Alle neuen Instanzen aktivieren dieses Attribut standardmäßig.
• report-event-health=TRUE: Erfasst die Ergebnisse der Systemdiagnose in Ihren Gastattributen.

Der notebooks-collection-agent-Dienst benötigt keine speziellen Berechtigungen, um in die Gastattribute der Instanz zu schreiben.

Agent Platform Workbench-Instanz mit aktivierten Gastattributen für den Systemzustand erstellen

Wenn Sie Gastattribute für den Systemzustand verwenden möchten, um den Zustand der Agent Platform Workbench-Instanz zu melden, müssen Sie beim Erstellen einer Agent Platform Workbench-Instanz das Kästchen Systemzustandsbericht aktivieren anklicken.

Sie können den Systemzustandsbericht über die Cloud de Confiance Console oder die Google Cloud CLI aktivieren.

Systemzustand durch Gastattribute überwachen

Für Agent Platform Workbench-Instanzen, für die die zugehörigen Gastattribute aktiviert sind, können Sie die Werte der Gastattribute zum Systemzustands mithilfe der Cloud de Confiance Console, der Google Cloud CLI mit Compute Engine-Befehlen oder der Google Cloud CLI mit Gemini Enterprise Agent Platform Workbench-Befehlen abrufen.

gcloud compute instances get-guest-attributes INSTANCE_NAME \
    --zone ZONE

 NAMESPACE   KEY                         VALUE
 notebooks   docker_proxy_agent_status   1
 notebooks   docker_status               1
 notebooks   jupyterlab_api_status       1
 notebooks   jupyterlab_status           1
 notebooks   system-health               1
 notebooks   updated                     2023-06-20 17:00:00.12345

 NAMESPACE   KEY                         VALUE
 notebooks   docker_proxy_agent_status   -1
 notebooks   docker_status               -1
 notebooks   jupyterlab_api_status       1
 notebooks   jupyterlab_status           1
 notebooks   system-health               -1
 notebooks   updated                     2023-06-20 17:00:00.12345

Benutzerdefinierte Messwerte an Monitoring melden

Mit Agent Platform Workbench-Instanzen können Sie den Systemstatus und JupyterLab-Messwerte erfassen und an Cloud Monitoring melden. Diese benutzerdefinierten Messwerte unterscheiden sich von den Standardmesswerten, die gemeldet werden, wenn Sie Monitoring auf Ihrer Agent Platform Workbench-Instanz installieren.

Zu den an Monitoring gemeldeten benutzerdefinierten Messwerten gehören:

• Der Systemzustand dieser Hauptdienste für Agent Platform Workbench:

  • Docker-Dienst
  • Docker-Reverse-Proxy-Agent
  • Jupyter-Dienst
  • Jupyter API

• Die folgenden JupyterLab-Messwerte:

  • Anzahl der Kernel
  • Anzahl der Terminals
  • Anzahl Verbindungen
  • Anzahl der Sitzungen
  • Maximaler Arbeitsspeicher
  • Großer Arbeitsspeicher
  • Aktueller Arbeitsspeicher

Wie Instanzen benutzerdefinierte Messwerte an Monitoring melden

Wenn Sie benutzerdefinierte Messwerte an Monitoring melden möchten, müssen Sie die Metadateneinstellung report-notebook-metrics beim Erstellen einer Agent Platform Workbench-Instanz aktivieren.

Sie müssen außerdem dafür sorgen, dass das Dienstkonto der Agent Platform Workbench-Instanz die Berechtigung „Monitoring-Messwert-Autor“ (roles/monitoring.metricWriter) hat. Weitere Informationen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Gemini Enterprise Agent Platform Workbench-Instanz erstellen, die benutzerdefinierte Messwerte an Monitoring meldet

Wenn Sie benutzerdefinierte Messwerte an Monitoring melden möchten, müssen Sie das Kästchen Benutzerdefinierte Messwerte an Cloud Monitoring melden anklicken, wenn Sie eine Agent Platform Workbench-Instanz erstellen.

Sie können das Melden benutzerdefinierter Messwerte an Cloud Monitoring mit der Cloud de Confiance Console oder der gcloud CLI aktivieren.

Dem Dienstkonto die Berechtigungen von „Monitoring-Messwert-Autor“ erteilen

Nachdem Sie die neue Agent Platform Workbench-Instanz erstellt haben, erteilen Sie dem Dienstkonto für die Agent Platform Workbench-Instanz die Berechtigungen von „Monitoring-Messwert-Autor“ (roles/monitoring.metricWriter). Weitere Informationen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Benutzerdefinierte Messwerte mit Monitoring beobachten

Für Agent Platform Workbench-Instanzen, für die das Melden benutzerdefinierter Messwerte aktiviert ist, können Sie Ihre benutzerdefinierten Messwerte mithilfe der Cloud de Confiance Console überwachen.

1. Rufen Sie in der Cloud de Confiance Console die Seite Instanzen auf.

   Zur Seite „VM-Instanzen“

2. Klicken Sie auf den Namen der Instanz, deren benutzerdefinierte Messwerte Sie aufrufen möchten.

3. Klicken Sie auf der Seite Instanzdetails auf den Tab Monitoring. Sehen Sie sich die benutzerdefinierten Messwerte für Ihre Instanz an.

Monitoring auf einer Instanz installieren

Mit dieser Option wird Monitoring automatisch installiert. Die Installation erfordert 256 MB Speicherplatz. Eine Internetverbindung ist erforderlich, damit die Messwerte an Monitoring gemeldet werden können.

Wie Instanzen System- und Anwendungsmesswerte melden

Wenn Sie System- und Anwendungsmesswerte melden möchten, indem Sie Cloud Monitoring auf Ihrer Agent Platform Workbench-Instanz installieren, müssen Sie das Kästchen Cloud Monitoring-Agent installieren anklicken, wenn Sie eine Agent Platform Workbench-Instanz erstellen. Diese Messwerte unterscheiden sich von den benutzerdefinierten Messwerten, die gemeldet werden, wenn Sie die Metadateneinstellung report-notebook-metrics aktivieren.

Agent Platform Workbench-Instanz erstellen, die System- und Anwendungsmesswerte an Monitoring meldet

Sie können Monitoring auf Ihrer Agent Platform Workbench-Instanz über die Cloud de Confiance Console oder die gcloud CLI installieren.

System- und Anwendungsmesswerte über Monitoring überwachen

Für Agent Platform Workbench-Instanzen, auf denen Monitoring installiert ist, können Sie Ihre System- und Anwendungsmesswerte mithilfe der Cloud de Confiance Console überwachen:

1. Rufen Sie in der Cloud de Confiance Console die Seite Instanzen auf.

   Zur Seite „VM-Instanzen“

2. Klicken Sie auf den Instanznamen, für den Sie die System- und Anwendungsmesswerte aufrufen möchten.

3. Klicken Sie auf der Seite Instanzdetails auf den Tab Monitoring. Sehen Sie sich die System- und Anwendungsmesswerte für Ihre Instanz an. Informationen zum Interpretieren dieser Messwerte finden Sie unter Ressourcenmesswerte überprüfen.

Systemzustand mit dem Diagnosetool überwachen

Agent Platform Workbench-Instanzen enthalten ein integriertes Diagnosetool, mit dem Sie den Systemzustand Ihrer Instanzen überwachen können.

Vom Diagnosetool ausgeführte Aufgaben

Das Diagnosetool führt die folgenden Aufgaben aus:

• Verifiziert den Status der folgenden Agent Platform Workbench-Hauptdienste:

  • Docker-Dienst
  • Docker-Reverse-Proxy-Agent
  • Jupyter-Dienst
  • Jupyter API

• Prüft, ob der Speicherplatz für Boot- und Datenlaufwerke über einen Grenzwert von 85 % hinaus verwendet wird.

• Installiert lsof (Internetverbindung erforderlich).

• Erfasst die folgenden Instanzlogs:

  • Netzwerkinformationen (ifconfig, netstat)
  • Logs im Ordner /var/log/
  • Docker-Statusinformationen
  • lsof-Daten (geöffnete Dateien)
  • Docker-Dienststatus
  • Status des Proxy-Reverse-Agents
  • Jupyter-Dienststatus
  • Jupyter API-Status
  • Konfigurationsdatei für den Proxy-Agent
  • Python-Prozesse

• Führt die folgenden Befehle aus und erfasst die Ergebnisse:

  • pip freeze
  • conda list
  • gcloud compute instances describe INSTANCE_NAME
  • gcloud config list

Diagnosetool ausführen

Wenn Ihre Instanz einen benutzerdefinierten Container verwendet, lesen Sie die Dokumentation zu benutzerdefinierten Containern für die Agent Platform Workbench unter Diagnosetool ausführen.

So führen Sie das Diagnosetool in einer Instanz aus, die keinen benutzerdefinierten Container verwendet:

1. Stellen Sie eine SSH-Verbindung zur Agent Platform Workbench-Instanz her.

2. Führen Sie im SSH-Terminal die folgenden Befehle aus:

   sudo -i
   cd /opt/deeplearning/bin/
   ./diagnostic_tool.sh

   Das Diagnosetool erfasst die Logs, komprimiert sie in einer .tar.gz-Datei und speichert die Datei im Ordner /tmp/.

3. Extrahieren Sie die Datei und bewerten Sie den Inhalt. Die Inhalte umfassen:

   • log-Ordner: Logs aus dem Ordner var/log/
   • report.log: Ausgabe für alle erfassten Befehle
   • proxy-agent-config.json: Informationen zur Proxykonfiguration
   • Docker-Log: Eine -json.log-Datei, die Docker-Containerlogs enthält

Sie können die folgenden Optionen mit dem Diagnosetool verwenden.

Nächste Schritte

• weitere Informationen zu VM-Metadaten

• Mehr zu Monitoring