ArcGIS Notebook Server zeichnet alle auf einer Site auftretenden Ereignisse sowie alle damit verbundenen Fehler in Protokollen auf. Diese Protokolle stehen den Site-Administratoren zur Verfügung.
Protokolle sind ein wichtiges Werkzeug zum Überwachen und Beheben von Problemen mit der ArcGIS Notebook Server-Site. Anhand der Informationen in den Protokollen können Sie Fehler identifizieren und Kontext zum Lösen von Problemen und Beheben von Fehlern bereitstellen. Die Protokolle dienen auch als Methode zur Aufzeichnung von Ereignissen, die in Ihrer Site auftreten.
Die folgenden Ereignistypen werden beispielsweise in den Protokollen aufgezeichnet:
- Installations- und Upgradeereignisse wie das Autorisieren von Software und das Erstellen von Sites
- Öffnen und Schließen von ArcGIS Notebooks
- Von der Site durchgeführte Bereinigungsaufgaben
- Von Administratoren durchgeführte Ereignisse im Rahmen des Site-Managements, wie das Hinzufügen oder Entfernen von Notebook-Runtimes, das Erstellen von Serververzeichnissen oder das Konfigurieren von Sicherheitseinstellungen
- Sicherheitsereignisse wie das Anmelden von Benutzern bei der Site oder das Importieren und Exportieren von SSL-Zertifikaten
Nicht alle Ereignisse werden jedoch in den ArcGIS Notebook Server-Protokollen aufgezeichnet. Dazu zählen das Verbinden der Site mit einem Portal und das Aufheben einer solchen Verbindung. Ereignisse, die in ArcGIS Notebooks auftreten – Inhalte hinzufügen, Zellen ausführen usw. – werden nicht aufgezeichnet. Ebenso nicht Ereignisse, die innerhalb der Docker-Container Ihres Computers auftreten. Zum Anzeigen von containerspezifischen Protokollen finden Sie weitere Informationen unter Anzeigen von Docker-Container-Protokollen.
Verfügbare Protokollierungsebenen
Jedes Protokoll hat eine Protokoll-Detaillierungsebene, die eine der folgenden sein kann (aufgelistet vom geringsten bis zum höchsten Detailgrad):
- Schwerwiegend: Schwerwiegende Probleme, die ein sofortiges Eingreifen erfordern.
- Warnung: Mittelschwere Probleme, die Ihre Aufmerksamkeit verlangen.
- Info: Allgemeine administrative Meldungen der Notebook-Server-Site, einschließlich Meldungen über das Erstellen und Starten des Services.
- Fein: Allgemeine Meldungen, die aus der Verwendung des Servers resultieren, wie beispielsweise die Namen der eingegangenen Operationsanfragen.
- Ausführlich: Meldungen, die nähere Informationen dazu bereitstellen, wie der Server einen Vorgang ausführt.
- Debuggen: Äußerst ausführliche Meldungen für Entwickler und Support-Techniker, die für die Problembehandlung einen genauen Einblick in den Status des Servers benötigen. Aufgrund der Menge der erstellten Protokolle nicht für den Einsatz in Produktionssystemen empfohlen.
Im ArcGIS Notebook Server-Administratorverzeichnis können Sie die detaillierteste Protokollierungsebene angeben. Wenn Sie die Ebene beispielsweise auf Fein festlegen, werden für Ihre Server-Site Meldungen mit den Detaillierungsebenen Schwerwiegend, Warnung, Info und Fein protokolliert.
Aufrufen und Abfragen von Serverprotokollen
Im ArcGIS Notebook Server-Administratorverzeichnis können Sie Serverprotokolle abfragen, anzeigen, konfigurieren und löschen.
Führen Sie folgende Schritte aus, um auf die Protokolle zuzugreifen.
- Melden Sie sich beim Administratorverzeichnis an. Die URL hat das Format https://notebookserver.domain.com:11443/arcgis/adminoder https://notebookserver.domain.com/<webadaptorname>/admin.
- Klicken Sie auf Logs > Query, um aktuelle Protokolle abzufragen und zu prüfen. Mit den Filtersteuerelementen auf der Seite können Sie Ereignisse nach Kategorien wie Zeitraum oder Detaillierungsebene eingrenzen.
- Klicken Sie auf Logs > Settings, um Protokolleinstellungen zu verwalten, wie die standardmäßige Detaillierungsebene (oben erläutert), die Dauer, für die Protokolle auf der Festplatte aufbewahrt werden, und den Speicherort, in den die Protokolle geschrieben werden.
- Klicken Sie auf Clean Logs, um alle Protokolldateien aus der ArcGIS Notebook Server-Site zu löschen.
Anzeigen von Docker-Container-Protokollen
Sie können Protokolle, die spezifisch für die Docker-Container Ihrer Site sind, über die Befehlszeilenschnittstelle von Docker wie folgt anzeigen.
- Melden Sie sich beim Administratorverzeichnis an. Die URL hat das Format https://notebookserver.domain.com:11443/arcgis/adminoder https://notebookserver.domain.com/<webadaptorname>/admin.
- Navigieren Sie zu System > Container. Suchen Sie den Container, dessen Protokolle Sie anzeigen möchten, und klicken Sie auf seine ID.
- Öffnen Sie die JSON-Ansicht der Infoseite des Containers, indem Sie ihrer URL ?f=pjson hinzufügen, sodass das URL-Format https://notebookserver.arcgis.com/<webadaptorname>/admin/system/containers/<container>?f=pjson lautet.
- Suchen Sie die containerId des Containers, und notieren Sie sich den Wert.
- Öffnen Sie die Eingabeaufforderung als Benutzer mit Docker-Berechtigungen.
- Führen Sie den Befehl docker logs <containerId> mit dem vorhin notierten Wert aus. Dadurch werden die für diesen Container spezifischen Docker-Protokolle zurückgegeben.