Arbeiten mit Systemprotokollen

In ArcGIS Enterprise on Kubernetes werden in der Organisation eingetretene Ereignisse sowie mit diesen Ereignissen verknüpfte Fehler in Protokollen aufgezeichnet. Die Protokolle können in ArcGIS Enterprise Manager abgerufen oder mit einer Beobachtbarkeits-Lösung von Drittanbietern erfasst werden.

Mithilfe der Protokolle können Sie Probleme in der Organisation überwachen und beheben. Anhand der Informationen in den Protokollen können Sie Fehler identifizieren und Kontext zum Beheben von Problemen bereitstellen. Die Protokolle umfassen außerdem einen Verlauf der Ereignisse, die im Laufe der Zeit aufgetreten sind, und geben Aufschluss über entsprechende Muster.

Verwenden von Enterprise Manager

Wenn ein Ereignis in Ihrer Site auftritt, wird es erfasst und in den Protokollen aufgezeichnet. Fragen Sie die Protokolle ab, um Meldungen anzuzeigen, die mit dem Ereignis verknüpft sind. Um die aktuellen Meldungen in Ihrer Site abzufragen und anzuzeigen, führen Sie die folgenden Schritte aus:

Melden Sie sich als Administrator bei ArcGIS Enterprise Manager an.
Klicken Sie auf der Seitenleiste auf die Schaltfläche Protokolle, um die aktuellen Protokolle anzuzeigen.

Einige Meldungen werden mit zusätzlichen Informationen zurückgegeben.

In allen Protokollen werden bestimmte Informationen über das Ereignis erfasst. Sie können Spalten, in denen Folgendes angezeigt wird, anzeigen und zwischen den Spalten wechseln:

Datum und Uhrzeit des Protokollereignisses
Protokollierungsebene des Ereignisses
Protokollmeldung
Quelle des Protokollereignisses
Anforderungs-ID des Protokollereignisses
Mit dem Ereignis verknüpfter Benutzername
Service-Typ, bei dem das Ereignis aufgetreten ist
Knoten, an dem das Protokollereignis aufgetreten ist
Protokollcode des Ereignisses
Stapelverfolgung des Ereignisses

Sie können Protokolle auch nach Uhrzeit, Protokollierungsebene, Quelle, Anforderungs-ID, Benutzername, Service-Typ und Protokollcode filtern.

Hinweis:

Wenn die Organisation keine Protokolle abrufen kann, überprüfen Sie den Status des Systemspeichers. Die Organisation hat keinen Zugriff auf die Protokolle, wenn der Data Store vom Typ "spatiotemporal" und der Indexspeicher fehlerbehaftet sind. Verwenden Sie Lens oder eine andere Kubernetes-IDE, um Kubernetes-Ereignisse anzuzeigen, die Protokolle der administrativen Pods zu überprüfen und bei Bedarf Pods neu zu starten.

Aktualisieren der Aufbewahrungsdauer von Protokollen

Sie können eine Aufbewahrungsrichtlinie für Ihre Systemprotokolle festlegen. Standardmäßig werden Systemprotokolle 60 Tage lang aufbewahrt, bevor sie gelöscht werden.

Wenn Sie die Aufbewahrungsdauer ändern möchten, gehen Sie folgendermaßen vor:

Klicken Sie auf der Seite Protokolle auf Einstellungen.
Aktualisieren Sie auf der Seite Protokolleinstellungen die Aufbewahrungsdauer von Protokollen.
Klicken Sie auf Speichern.

Löschen von Protokollmeldungen

Gehen Sie zum Löschen von Protokollmeldungen folgendermaßen vor:

Klicken Sie auf der Seite Protokolle auf die Schaltfläche Löschen .
Auf der Seite Protokollmeldungen löschen haben Sie die folgenden Optionen:
- Protokollierungsebene(n) auswählen: Wählen Sie eine oder mehrere Protokollierungsebenen aus, die Sie löschen möchten.
- Zeitraum auswählen: Wählen Sie den Zeitraum aus, für den Sie Protokollmeldungen löschen möchten.
- Benutzerdefinierten Zeitraum auswählen: Wählen Sie bei Aktivierung einen benutzerdefinierten Zeitraum aus, für den Sie Protokollmeldungen löschen möchten.
Klicken Sie auf Löschen.

Verwenden von Drittanbieter-Werkzeugen

Neben der Speicherung durch ArcGIS Enterprise werden Systemprotokolle auch in Stdout (Standardausgabe) gestreamt. Auf diese Weise können Sie die Protokolle mit Beobachtbarkeits-Lösungen von Drittanbietern wie Datadog oder Splunk auswerten. Jeder stdout-Protokolleintrag wird als unabhängiges strukturiertes JSON-Objekt ausgegeben, das mit Newline-Delimited JSON in eine eigene Zeile geschrieben wird.

Der folgende Beispiel-Protokolleintrag veranschaulicht das Schema der Anwendungsprotokolle, die "eventType":"arcgis-logs" enthalten. Auditprotokolle für sicherheitsbezogene Ereignisse werden separat unter Verwendung eines anderen Schemas in Stdout gestreamt.

{"date":1777073486.102182,"msgTimestamp":"2026-04-24T23:31:25,968","logLevel":"DEBUG","source":"Workflow Manager","logCode":"46300","processID":"1","threadID":"1","className":"WorkflowManager","msg":"Creating ArcGIS Client request for https://arcgis-rest-portal-api.arcgis.svc.cluster.local:8443/arcgis/sharing/rest/generateToken ","stackTraces":"\n","input":{"type":"log"},"log":{"file":{"path":"/arcgisusr/logs/arcgis_logfile.log"}},"fields":{"serviceTypes":"","deploymentID":""},"pod":"arcgis-workflow-manager-gkruq-6cff58b755-pnpq9","eventType":"arcgis-logs"}

Hinweis:

Das Feld date erfasst den Zeitstempel, an dem das Ereignis an Stdout gestreamt wurde, während das Feld msgTimestamp die Zeit des ursprünglichen Protokollereignisses erfasst.

Auf Stdout-Protokolle kann mit dem kubectl logs Befehl zugegriffen werden, um die Protokolle aus dem fluent-bit-Container innerhalb des Ziel-Pods abzurufen. Weitere Informationen finden Sie in der Kubernetes-Dokumentation zu kubectl-Protokolle

Problembehandlung mit Protokollen

Wenn Sie beim Service oder Knoten ein Problem vermuten oder ein Benutzer ein Problem meldet, können Sie das Ereignis reproduzieren, das Ereignis anhand der Protokolle erfassen und die Protokolle nach Informationen zu dem Ereignis abfragen. Danach lösen Sie das durch das Ereignis verursachte Problem anhand der Informationen im Protokoll.

Wenn ein Problem vermutet oder gemeldet wird, versuchen Sie, dieses Problem zu reproduzieren. Wenn das Problem reproduziert werden kann, fragen Sie die entsprechenden Protokolle ab, und überprüfen Sie die Meldungen auf Informationen, die Ihnen weiterhelfen könnten. Wenn beispielsweise ein Benutzer ein Performance-Problem mit einem Web-Service gemeldet hat, reproduzieren Sie seine Aktionen, und rekonstruieren Sie den Verlauf des Ereignisses anhand der Protokolle. Möglicherweise gibt eine Fehlermeldung Aufschluss über die Ursache des Problems.

Wenn keine Informationen vorhanden sind, können Sie die Protokollierungsebene erhöhen. Dadurch wird der Bereich der aufgezeichneten Protokolle erweitert, und Sie erhalten möglicherweise weitere hilfreiche Informationen.

Protokollierungsebenen

Die protokollierten Ereignisse können unterschiedlich detailliert sein und von der Ebene Schwerwiegend, womit auf ein Problem hingewiesen wird, das ein sofortiges Eingreifen erfordert, bis zur Ebene Ausführlich reichen, d. h. eine ausführliche, informative Meldung enthalten, die durch die normale Verwendung des Servers generiert wird.

In der folgenden Tabelle werden die Protokollierungsebenen beschrieben:


Protokollierungsebene	Beschreibung	Beispielmeldung
Severe	Ernste Probleme, die ein sofortiges Eingreifen erfordern. Diese Ebene umfasst nur Meldungen vom Typ "Severe".	Anforderung kann nicht verarbeitet werden. Service X nicht gefunden.
Warnung	Mittelschwere Probleme, die Ihre Aufmerksamkeit verlangen. Diese Ebene umfasst auch Meldungen vom Typ "Severe".	Fehler beim Anmelden. Benutzername oder Kennwort ungültig.
Info	Allgemeine Verwaltungsmeldungen, einschließlich Informationen zum Erstellen und Starten des Service. Diese Ebene umfasst auch Meldungen vom Typ "Sever" und "Warning"	Zugriff auf die Einstellungen des Organisationskontos.
Fine	Allgemeine Meldungen mit Informationen wie etwa die Namen der eingegangenen Operationsanfragen. Diese Ebene umfasst auch Meldungen vom Typ "Severe", "Warning" und "Info".	Suche nach abgelaufenen Elementen.
Verbose	Meldungen mit detaillierten Informationen darüber, wie die Bereitstellung bestimmte Operationen ausführt, z. B. der Hinweis, dass jeder Layer eines Kartenservice erfolgreich dargestellt wurde, wie schnell der Layer dargestellt wurde oder wie viel Zeit der Zugriff auf die Quelldaten des Layers in Anspruch genommen hat. Diese Ebene umfasst auch Meldungen vom Typ "Severe", "Warning", "Info" und "Fine".	Beginn der Layer-Darstellung: Landkreise
Debug	Meldungen für Entwickler und Support-Techniker, die sich für die Problembehandlung einen Überblick über das Problem verschaffen müssen. Es wird empfohlen, diese Ebene nicht in einer Produktionsumgebung zu verwenden, da dies zu einer Reduzierung der Performance führen kann. Falls Sie kein Problem beheben, verwenden Sie stattdessen die Ebene "Warnung".	Bereinigen von Verzeichnissen.

Aktualisieren der Protokollierungsebene

Wenn Sie in ArcGIS Enterprise Manager Systemprotokolle verwenden, müssen Sie möglicherweise eine höhere Protokollierungsebene verwenden, um Ereignisse zu erfassen und sich einen Überblick über die Ereignisse zu verschaffen.

Sie können den Bereich der aufgezeichneten Protokolle erweitern. Sie können auch Protokolle zum Erstellen und Starten von Services untersuchen. Ändern Sie hierzu die Standardeinstellung der Protokollierungsebene von Warnung in Info.

Gehen Sie zum Aktualisieren der Protokollierungsebene in ArcGIS Enterprise Manager wie folgt vor:

Klicken Sie auf der Seite Protokolle auf Einstellungen.
Legen Sie auf der Seite Protokolleinstellungen die gewünschte Standard-Protokollierungsebene fest.
Klicken Sie auf Speichern.

Aktualisieren des Protokollindexes

Zum Beheben von Problemen beim Zugriff auf Protokolle, z. B. wenn keine neuen Protokolle erstellt werden oder vorhandene Protokolle nicht mehr verfügbar sind, können Sie den Protokollindex aktualisieren.

Gehen Sie in ArcGIS Enterprise Manager folgendermaßen vor, um den Protokollindex zu aktualisieren:

Klicken Sie auf der Seite Protokolle auf Einstellungen.
Klicken Sie auf der Seite Protokolleinstellungen auf Protokollindex aktualisieren.