Arbeiten mit ArcGIS Notebook Server-Protokollen

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. Ereignisse, die in ArcGIS Notebooks auftreten – Inhalte hinzufügen, Zellen ausführen usw. – werden nicht aufgezeichnet, ebenso wenig wie 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 Service.
• 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.

Einstellungen zur Protokollabfrage in Manager

Ab Version 10.8 umfasst ArcGIS Notebook Server Manager die Seite Protokolle. Auf dieser Seite können Sie alle Protokolle für Ihre ArcGIS Notebook Server-Site abfragen.

1. Melden Sie sich als Administrator bei Ihrem ArcGIS Enterprise-Portal an, und öffnen Sie ArcGIS Notebook Server Manager.
2. Öffnen Sie die Seite Protokolle.
3. Die Filterparameter für die Abfrage befinden sich oben auf der Seite. Anhand dieser Parameter können Sie Ihre Suche eingrenzen oder ausweiten.

   • Protokoll-Level: Das niedrigste Protokoll-Level für die Abfrage (siehe obiger Abschnitt). Es werden nur Datensätze mit diesem oder einem höheren Protokoll-Level ausgegeben. Der Standard-Level ist WARNING.
   • Protokollzeit: Die Zeitspanne für die Protokollsuche. Sie können eine Abfrage auf die letzten 15 Minuten, die letzte Stunde, die letzten 6 Stunden oder die letzten 24 Stunden, die letzte Woche oder die letzten 30 Tage begrenzen oder alle Protokolle seit Erstellung der Site anzeigen.

     Tipp:

     Verwenden Sie das Administratorverzeichnis zur Abfrage von Protokollen, wenn Sie eine Endzeit angeben möchten, die nicht der aktuellen Zeit entspricht, beispielsweise zur Abfrage von Protokollen von vor zwei bis drei Tagen.

   • Computer: Begrenzen Sie die Abfrage auf Protokolle von einem Ihrer ArcGIS Notebook Server-Computer, oder zeigen Sie die Protokolle von allen Computern an.
   • Protokollcodes: Ein Code oder eine Reihe von Protokollcodes, die einer Protokollmeldung zugewiesen sind. Wird dieses Feld leer gelassen, werden alle Protokollcodes angezeigt.
   • Benutzer: Der Benutzername eines oder mehrerer Benutzer (durch Komma getrennt), dessen zugehörige Protokolle abgefragt werden sollen. Einige Protokollmeldungen beziehen sich auf die Aktionen eines bestimmten Benutzers.

4. Klicken Sie auf Suchen, um die Abfrage auszuführen. Alle Protokolle, die den Abfrageparametern entsprechen, werden in der Tabelle angezeigt.

Ändern von Protokolleinstellungen in Manager

Sie können in ArcGIS Notebook Server Manager auch die Protokolleinstellungen für Ihre Site ändern.

1. Melden Sie sich als Administrator bei Ihrem ArcGIS Enterprise-Portal an, und öffnen Sie ArcGIS Notebook Server Manager.
2. Öffnen Sie die Seite Einstellungen, und klicken Sie auf Protokolle.
3. Sie können die folgenden Einstellungen ändern:

   • Protokollverzeichnis: Der Speicherort für Ihr Protokollverzeichnis auf der Festplatte. Wenn Ihre Site mehrere Computer umfasst, stellen Sie sicher, dass es sich bei diesem Pfad um eine UNC-Freigabe handelt.
   • Protokoll-Level: Die detaillierteste Protokollierungsebene, die von Ihrer Site verwendet wird. Wird hier die Einstellung FINE gewählt, werden auf Ihrer Site beispielsweise keine Protokolle der Levels VERBOSE oder DEBUG beibehalten.
   • Anzahl der Tage, für die Protokolle beibehalten werden: Die Anzahl der Tage, nach der Protokollmeldungen gelöscht werden. Berücksichtigen Sie den verfügbaren Speicherplatz auf dem Laufwerk Ihres Protokollverzeichnisses sowie die gewählte Einstellung für das Protokoll-Level und das Aktivitätsniveau auf Ihrer Site. Wenn Sie beispielsweise festlegen, dass Protokolle auf detaillierterer Ebene geschrieben werden, müssen Sie möglicherweise die Anzahl der Tage, für die Protokolle beibehalten werden, reduzieren.

4. Klicken Sie auf Speichern, um die Änderungen zu bestätigen.

Abfragen von Serverprotokollen im Administratorverzeichnis

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.

1. Melden Sie sich beim Administratorverzeichnis an. Die URL hat das Format https://notebookserver.domain.com:11443/arcgis/admin oder https://notebookserver.domain.com/<webadaptorname>/admin.
2. 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.
3. 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.
4. Klicken Sie auf Clean Logs, um alle Protokolldateien aus der ArcGIS Notebook Server-Site zu löschen.

Anzeigen von Docker-Containerprotokollen mit ArcGIS Notebook Server Manager

Mit ArcGIS Notebook Server Manager können Sie die für die Docker-Container Ihrer Site spezifischen Protokolle anzeigen.

1. Melden Sie sich bei ArcGIS Notebook Server Manager Ihres Portals als Administrator an. Die URL hat das Format https://webadaptorhost.domain.com/webadaptorname/home/notebook/manager.html.
2. Navigieren Sie zur Registerkarte Container.
3. Klicken Sie auf die Schaltfläche Protokolle anzeigen, um die Containerprotokolle des ausgewählten Computers anzuzeigen.

Anzeigen von Docker-Containerprotokollen mit der Docker-Befehlszeile

Sie können Protokolle, die spezifisch für die Docker-Container Ihrer Site sind, über die Befehlszeilenschnittstelle von Docker wie folgt anzeigen.

1. Melden Sie sich beim Administratorverzeichnis an. Die URL hat das Format https://notebookserver.domain.com:11443/arcgis/admin oder https://notebookserver.domain.com/<webadaptorname>/admin.
2. Navigieren Sie zu System > Container. Suchen Sie den Container, dessen Protokolle Sie anzeigen möchten, und klicken Sie auf seine ID.
3. Ö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.
4. Suchen Sie die containerId des Containers, und notieren Sie sich den Wert.
5. Öffnen Sie ein Terminal als Benutzer mit Docker-Berechtigungen.
6. 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.