Die Überwachung von Serverprotokollen kann zum Ermitteln von Fehlern und Beheben von Problemen im Zusammenhang mit Ihrer Site hilfreich sein. Die Portal-Protokolle können Sie in ArcGIS Server Manager anzeigen, abfragen, konfigurieren und löschen. Mit dem Manager werden die Protokollmeldungen zu einer Tabelle zusammengefasst, die Sie lesen und bearbeiten können.
Anhand der Abschnitte in diesem Hilfethema werden die Serverprotokolle und deren Verwendung bei der Behebung von Problemen beschrieben.
- Erfassen, Abfragen und Anzeigen von Ereignissen
- Protokolle
- Verwenden von Protokollfiltern zum Eingrenzen der Suche
- Durchblättern von Serverprotokollen
- Anzeigen der Protokolle in einem druckbaren Format
- Löschen von Protokollen
Erfassen, Abfragen und Anzeigen von Ereignissen
Wenn ein Ereignis in Ihrer Site auftritt, wird es erfasst und in den Protokollen aufgezeichnet. Um Meldungen anzuzeigen, die mit dem Ereignis verknüpft sind, müssen Sie die Protokolle abfragen. Um die aktuellen Meldungen in Ihrer Site abzufragen und anzuzeigen, führen Sie die folgenden Schritte aus:
- Öffnen Sie Manager, und melden Sie sich alsAdministrator an. Falls Sie Hilfe zu diesem Schritt benötigen, finden Sie weitere Informationen unter Anmelden bei Manager.
- Klicken Sie auf Protokolle > Protokolle anzeigen, um die aktuellen Protokolle anzuzeigen. Einige Meldungen werden mit zusätzlichen Informationen zurückgegeben.
Informationen werden zu allen Ereignissen erfasst, darunter der Protokoll-Level, der Zeitpunkt, an dem das Ereignis aufgetreten ist, die Quellkomponente, von der es protokolliert wurde, der Computer, auf dem das Ereignis aufgetreten ist, der Protokollcode, der Benutzer, der mit dem Ereignis verknüpft ist, usw. All diese Informationen können zu einer effektiveren Problembehebung Ihres Portals beitragen. Eine detaillierte Erläuterung dieser Informationen finden Sie unter Protokolle.
Protokollierungsverhalten von Installationen und Postinstallationen
Beim Installieren oder Aktualisieren von ArcGIS Server, wird der Protokoll-Level des Servers auf Ausführlich festgelegt. Dies bedeutet, dass sehr detaillierte Meldungen während des Installations- oder Aktualisierungsvorgangs protokolliert werden.
Wenn während dieses Vorgangs ein Fehler auftritt und Sie die Protokolle überprüfen möchten, um den Fehler zu beheben, müssen Sie zunächst ermitteln, ob Sie Zugriff auf ArcGIS Server Manager haben. Sollte dies der Fall sein, fragen Sie die Protokolle ab, und überprüfen Sie die Meldungen. Falls nicht, überprüfen Sie die Protokollmeldungen auf der Festplatte. Um auf die Protokolle auf der Festplatte zuzugreifen, navigieren Sie zum Protokollverzeichnis, und öffnen Sie die aktuelle Protokolldatei (z. B. C:\arcgisserver\logs\<machine name>\server\server-20150101.095803-8596-0.0.log). Falls erforderlich, können Sie diese Angaben auch an den Esri Support weiterleiten.
Nach Abschluss des Installations- oder Aktualisierungsvorgangs, wird der Protokoll-Level des Servers auf Warnung festgelegt. Dies bedeutet, dass nur mittelschwere bis ernste Probleme protokolliert werden. Wenn ein Benutzer des Servers ein Problem meldet, müssen Sie den Protokoll-Level möglicherweise ändern, um differenziertere Meldungen für das spezifische Problem zu erfassen. Weitere Informationen zum Ändern des Protokoll-Levels finden Sie unter Festlegen von Protokolleinstellungen für den Server.
Wenn das System nicht ordnungsgemäß funktioniert
Wenn Sie feststellen, dass ein Problem beim Server vorliegt oder ein Benutzer ein Problem meldet, müssen 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, verwenden Sie die folgenden Informationen, um das Ereignis anhand der Protokolle zu erfassen:
- Versuchen Sie, das Problem zu reproduzieren
- Wenn das Problem reproduziert werden kann, fragen Sie die Protokolle ab, und überprüfen Sie die Meldungen auf Informationen zu dem Problem
- Wenn keine Informationen vorhanden sind, können Sie die Protokollierungsebene erhöhen. Reproduzieren Sie das Problem erneut, fragen Sie die Protokolle ab, und überprüfen Sie die Meldungen.
- Wenn die Protokollmeldungen entsprechende Informationen enthalten, überprüfen Sie die Informationen, um das Problem zu lösen.
- Falls das Problem nicht reproduziert werden kann, notieren Sie sich das Szenario, das zu dem Problem geführt hat, für den Fall, dass es erneut auftritt.
- Wenn das Problem reproduziert werden kann, fragen Sie die Protokolle ab, und überprüfen Sie die Meldungen auf Informationen zu dem Problem
Tipp:
Wenn sich das Problem auf die Veröffentlichung gehosteter Services bezieht, sollten Sie auch die Portal for ArcGIS-Protokolle überprüfen. Die Portal-Protokolle liefern möglicherweise zusätzliche Informationen, die bei der Behebung des Veröffentlichungsproblems behilflich sind.
Protokolle
Die spezifischen Informationen werden von allen Ereignissen erfasst, darunter der Protokoll-Level, der Zeitpunkt des Ereignisses und der Computer, auf dem es aufgetreten ist. All diese Informationen können zu einer effektiveren Problembehebung Ihres Servers beitragen.
Standardmäßig werden nur die Eigenschaften Level, Uhrzeit, Meldung, und Quelle im Protokollfenster angezeigt. Wenn Sie Eigenschaften zur Anzeige hinzufügen oder aus der Anzeige entfernen möchten, wählen Sie Spalten aus.
Tipp:
Ändern Sie die Spaltenreihenfolge in der Ereignisprotokollanzeige, indem Sie die Spaltenüberschriften per Drag & Drop verschieben. Klicken Sie auf die einzelnen Spaltenüberschriften, um eine Sortierung in aufsteigender oder absteigender Reihenfolge vorzunehmen.
Stockwerk
Protokollierte Ereignisse können in ihrer Detailliertheit von Schwerwiegend, womit auf ein Problem hingewiesen wird, das ein sofortiges Eingreifen erfordert, bis zu Ausführlich reichen, d. h. eine ausführliche, informative Meldung, die durch die normale Verwendung des Servers generiert wird.
Die folgenden Typen von Protokoll-Levels werden verwendet:
Protokollebene | Beschreibung | Beispielmeldung |
---|---|---|
Schwerwiegend | Ernste Probleme, die ein sofortiges Eingreifen erfordern. Dieser Level umfasst nur schwerwiegende Meldungen. | Anforderung kann nicht verarbeitet werden. Service-Planung/Landkreise/FeatureServer nicht gefunden. |
Warnung | Mittelschwere Probleme, die Ihre Aufmerksamkeit verlangen. Diese Ebene umfasst ebenfalls schwerwiegende Meldungen. | Fehler beim Anmelden. Benutzername oder Kennwort ungültig. |
Info | Allgemeine Verwaltungsmeldungen des Servers, einschließlich Meldungen zum Erstellen und Starten des Service. Diese Ebene umfasst auch schwerwiegende Meldungen und Warnungen. | Der Ordner "Planung" wurde erfolgreich erstellt. |
Fein | Allgemeine Meldungen, die aus der Verwendung des Servers resultieren, wie beispielsweise die Namen der eingegangenen Operationsanfragen. Diese Ebene umfasst auch schwerwiegende Meldungen, Warnungen und Informationsmeldungen. | Es wird nach abgelaufenen Elementen in C:\arcgisserver\directories\arcgisjobs gesucht. |
Ausführlich | Meldungen mit detaillierten Informationen darüber, wie der Server bestimmte Operationen ausführt, z. B. der Hinweis, dass jeder Layer eines Kartenservice erfolgreich dargestellt wurde, wie schnell der Layer dargestellt wurde und wie viel Zeit der Serverzugriff auf die Quelldaten des Layers in Anspruch genommen hat. Diese Ebene umfasst auch schwerwiegende Meldungen, Warnungen und Informationsmeldungen und allgemeine Meldungen. | Beginn der Layer-Darstellung: Landkreise |
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. 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 Serververzeichnissen. |
Aus | Die Protokollierung ist deaktiviert. Ereignisse werden nicht vom Server protokolliert. | n. z. |
Uhrzeit
Die Uhrzeit, zu der das protokollierte Ereignis aufgetreten ist. Ereignisse werden in chronologischer Reihenfolge angezeigt, wobei das jüngste Ereignis an erster Stelle erscheint. Klicken Sie auf die Spaltenüberschrift Zeit, um Meldungen in aufsteigender oder absteigender Reihenfolge zu sortieren.
Sie können das anzuzeigende Zeitintervall festlegen, wenn Sie die Protokolle abfragen.
Source
Bei der Quelle des protokollierten Ereignisses kann es sich um einen Service oder den Server handeln. Für mit Services verknüpfte Ereignisse werden der Name und der Typ des Service als Quelleigenschaft angezeigt. Für mit dem Server verknüpfte Ereignisse wird der Name der Umgebungskomponente, von der die Meldung protokolliert wurde, als Quelleigenschaft angezeigt.
Nachfolgend finden Sie einige Beispiele:
- Für ein mit dem Kartenservice "SampleWorldCities" verknüpftes Ereignis wird z. B. SampleWorldCities.MapServer angezeigt.
- Nachdem Sie auf Ihrer Site ein Server-Cluster erstellt haben, wird Admin als Komponente angezeigt, welche die Meldung protokolliert hat.
Sie können optional die anzuzeigende Quelle festlegen, wenn Sie die Protokolle abfragen.
Maschine
Jeder Servercomputer Ihrer Site verwaltet einen Satz von Protokollen, die spezifisch für den Computer sind. Wenn Sie ArcGIS Data Store bei Ihrer Site registriert haben, protokolliert jeder Data Store-Computer außerdem Meldungen speziell für diesen Computer.
Ein Server kann beispielsweise einen Fehler protokollieren, der besagt, dass der Speicherort des Konfigurationsspeichers nicht aktualisiert werden konnte. Nur diejenigen Meldungen, die sich auf Statistiken beziehen, welche für einen bestimmten Computer aufgezeichnet werden, enthalten die Eigenschaft "Computer".
Sie können den anzuzeigenden Computer festlegen, wenn Sie die Protokolle abfragen.
Code
Der mit der Meldung verknüpfte Protokollcode. Die Codes sind in mehreren Bereichen organisiert, wie in der Übersicht über Protokollcodes beschrieben.
Verstrichene Zeit
Die Zeitspanne (in Millisekunden) bis zum Abschluss des protokollierten Ereignisses. Zum Beispiel verfügt das Ereignis, das beim Exportieren eines Webkarten-Image protokolliert wird, über diese Eigenschaft, um die Zeitspanne anzugeben, die der Export des Webkarten-Image in Anspruch genommen hat.
Benutzername
Der Name des Benutzers, der die Anforderung, die zur Protokollmeldung geführt hat, abgeschickt hat. Diese Eigenschaft ist nützlich, um einzelne Benutzeraktivitäten zu verfolgen, wenn Sicherheit aktiviert ist.
Process
Die Prozess-ID des Computers, der das Ereignis protokolliert hat.
Thread
Der Serverprozess-Thread, der die Meldung generiert hat.
Anforderungs-ID
Die eindeutige ID-Zeichenfolge, die an jede Anforderung an den ArcGIS Server bei der Übermittlung angehängt wird und während des gesamten Lebenszyklus der Anforderung im System beibehalten wird.
Methodenname
Der Methodenaufruf im Service, der zur Protokollmeldung geführt hat.
Verwenden von Protokollfiltern zum Eingrenzen der Suchergebnisse
Um Ereignisse besser einzugrenzen und relevante Meldungen anzuzeigen, können Abfragen basierend auf Protokoll-Level, Protokollalter (Zeit), Quellkomponente und Computer durchgeführt werden. Sie können eine beliebige Anzahl dieser Filter als Teil Ihrer Abfrage kombinieren. Diese Filter können auf der Seite Protokolle anzeigen in Manager aufgerufen werden.
Protokollfilter
Ereignisse reichen in ihrer Detailliertheit von Schwerwiegend, womit auf ein Problem hingewiesen wird, das ein sofortiges Eingreifen erfordert, bis zu Ausführlich, d. h. eine ausführliche, informative Meldung, die durch die normale Verwendung des Servers generiert wird. Wählen Sie den gewünschten Level aus der Dropdown-Liste Protokollfilter aus. Eine detaillierte Zusammenfassung der einzelnen Ebenen finden Sie im Abschnitt Protokolltyp unten.
Age
Die vom Server protokollierten Ereignisse werden in chronologischer Reihenfolge angezeigt, wobei das jüngste Ereignis an erster Stelle erscheint. Um Ereignisse nach einem bestimmten Zeitrahmen zu filtern, geben Sie das gewünschte Zeitinkrement über die Dropdown-Liste Alter an:
Zeitinkrement | Beschreibung |
---|---|
Letzte 15 Minuten | Zeigt Ereignisse an, die innerhalb der letzten 15 Minuten protokolliert wurden |
Letzte Stunde | Zeigt Ereignisse an, die innerhalb der letzten Stunde protokolliert wurden |
Letzte 6 Stunden | Zeigt Ereignisse an, die innerhalb der letzten sechs Stunden protokolliert wurden |
Letzte 24 Stunden | Zeigt Ereignisse an, die innerhalb der letzten 24 Stunden protokolliert wurden |
Letzte Woche | Zeigt Ereignisse an, die innerhalb der letzten Woche protokolliert wurden, oder Ereignisse, die innerhalb der Zeitspanne protokolliert wurden, die Sie für das Speichern von Protokollen auf der Festplatte festgelegt haben. |
Seit Programmstart | Zeigt Ereignisse an, die seit dem letzten Neustart des Servers protokolliert wurden, oder Ereignisse, deren Protokollierung innerhalb der Zeitspanne erfolgte, die Sie für das Speichern von Protokollen auf der Festplatte festgelegt haben. |
Alle | Zeigt alle Ereignisse an, die seit der Installation von ArcGIS Server protokolliert wurden, oder Ereignisse, die innerhalb der Zeitspanne protokolliert wurden, die Sie für das Speichern von Protokollen auf der Festplatte festgelegt haben. |
Klicken Sie auf die Spaltenüberschrift Zeit, um Meldungen in aufsteigender oder absteigender Reihenfolge zu sortieren.
Denken Sie daran, dass die Abfrage nur Protokolle für die Zeitspanne zurückgibt, die Sie für die ArcGIS Server-Site zum Speichern von Protokollen auf der Festplatte festgelegt haben. Der Standardwert ist 90 Tage. Wenn Sie beispielsweise in der Konfiguration der Site für die Speicherung der Protokolle eine Zeitspanne von fünf Tagen festgelegt haben, werden bei der Auswahl von Letzte Woche im Filter Alter nur Protokolle der letzten fünf Tage zurückgegeben.
Tipp:
Klicken Sie auf Einstellungen, um festzulegen, wie lange der Server die Protokolle auf der Festplatte vorhalten soll. Weitere Informationen finden Sie unter Angeben von Serverprotokollierungseinstellungen.
Source
Bei der Quelle des protokollierten Ereignisses kann es sich um einen Service oder den Server handeln. Für mit Services verknüpfte Ereignisse werden der Name und der Typ des Service als Quelleigenschaft angezeigt. Für mit dem Server verknüpfte Ereignisse wird der Name der Umgebungskomponente, von der die Meldung protokolliert wurde, als Quelleigenschaft angezeigt.
Alle Quellen werden standardmäßig abgefragt (die Option Alle aus der Dropdown-Liste). Um einen bestimmten Service oder eine Serverumgebungskomponente abzufragen, wählen Sie im Filter Quelle den Namen des Service bzw. der Komponente aus. In der folgenden Tabelle werden die Quellen beschrieben, die für protokollierte Ereignisse angezeigt werden.
Hinweis:
Die unten beschriebenen Quellen "Admin", "Server", "Rest" und "Soap" sind im Filter Quelle unter Server-Framework zusammengefasst. Wählen Sie für eine Abfrage dieser Quellen aus der Dropdown-Liste des Filters Quelle den Eintrag Server-Framework aus.
Source | Beschreibung |
---|---|
Admin | Gibt an, dass die Meldung von der Verwaltungs-API protokolliert wurde. Die Verwaltungs-API ist die Serverschicht, die Ihnen die Verwaltung des Servers ermöglicht, z. B. das Erstellen der Site, das Hinzufügen von Computern und Services, das Konfigurieren von Clustern usw. |
Server | Gibt an, dass die Meldung von dem Teil der Serverumgebung protokolliert wurde, die für die Erstellung von Service-Instanzen zuständig ist. |
Rest | Gibt an, dass die Meldung vom REST-Handler des Servers protokolliert wurde. Die Komponente "Rest" protokolliert Meldungen aller Level. |
Soap | Gibt an, dass die Meldung vom SOAP-Handler des Servers protokolliert wurde. Die Komponente "Soap" protokolliert Meldungen aller Level. |
ArcGIS Data Store | Gibt an, dass die Meldung von ArcGIS Data Store protokolliert wurde. Es erscheinen nur dann Meldungen, wenn Sie ArcGIS Data Store bei ArcGIS Server registriert haben. |
<Servicename>.FeatureServer | Die Quelle ist ein Feature-Service. |
<Servicename>.GeocodeServer | Die Quelle ist ein Geokodierungs-Service. |
<Servicename>.GeoDataServer | Die Quelle ist ein Geodatenservice. |
<Servicename>.GeometryServer | Die Quelle ist ein Geometrieservice. |
Geometry.GeometryServer | Die Quelle ist der vorkonfigurierte Geometrieservice, der zusammen mit ArcGIS Server installiert wird. |
<Servicename>.GPServer | Die Quelle ist ein Geoverarbeitungsservice. |
CachingTools.GPServer | Die Quelle besteht aus den vorkonfigurierten Caching-Werkzeugen, die zusammen mit ArcGIS Server installiert werden. |
PrintingTools.GPServer | Die Quelle ist der vorkonfigurierte PrintingTools-Service, der zusammen mit ArcGIS Server installiert wird. |
PublishingTools.GPServer | Die Quelle besteht aus den vorkonfigurierten Veröffentlichungswerkzeugen, die zusammen mit ArcGIS Server installiert werden. |
<Servicename>.ImageServer | Die Quelle ist ein Image-Service. |
<Servicename>.KmlServer | Die Quelle ist ein KML-Service. |
<Servicename>.MapServer | Die Quelle ist ein Kartenservice. |
<Servicename>.NAServer | Die Quelle ist ein Netzwerkanalyse-Service. |
<Servicename>.WCSServer | Die Quelle ist ein Web-Coverage-Service. |
<Servicename>.WFSServer | Die Quelle ist ein Web-Feature-Service. |
<Servicename>.WMServer | Die Quelle ist ein Workflow Manager-Service. |
<Servicename>.WMSServer | Die Quelle ist ein WebKartenservice. |
<Servicename>.WMTSServer | Die Quelle ist ein WMTS-(Web Map Tile Service)-Service. |
<Servicename>.WPSServer | Die Quelle ist ein Webverarbeitungs-Service. |
<Servicename>.SceneServer | Die Quelle ist ein Szenen-Service. |
<Servicename>.SchematicsServer | Die Quelle ist ein Schematics-Service. |
<Servicename>.SearchServer | Die Quelle ist ein Such-Service. |
SampleWorldCities.MapServer | Die Quelle ist der vorkonfigurierte Kartenservice "SampleWorldCities", der zusammen mit ArcGIS Server installiert wird. |
Search.SearchServer | Die Quelle ist der vorkonfigurierte Search-Service, der zusammen mit ArcGIS Server installiert wird. |
Search_indexer.GPServer | Die Quelle ist der dem vorkonfigurierten Such-Service zugehörige _indexer-Geoverarbeitungsservice. |
<Searchservicename>_indexer.GPServer | Die Quelle ist der dem Such-Service zugehörige _indexer-Geoverarbeitungsservice. |
Maschine
Jeder Servercomputer Ihrer Site verwaltet einen Satz von Protokollen, die spezifisch für den Computer sind. Wenn Sie ArcGIS Data Store bei Ihrer Site registriert haben, protokolliert jeder Data Store-Computer außerdem Meldungen speziell für diesen Computer.
Alle Computer werden standardmäßig abgefragt (die Option Alle aus der Dropdown-Liste). Um Ereignisse abzufragen, die von einem bestimmten Computer protokolliert wurden, wählen Sie im Filter Computer den gewünschten Computer aus.
Durchblättern von Serverprotokollen
Wenn Sie im Modul Protokolle anzeigen eine Abfrage ausführen, werden im Protokollfenster die letzten 1.000 Meldungen angezeigt, die mit Ihrer Abfrage übereinstimmen. Im unteren Bereich des Protokollfensters wird die Zeitspanne dieser Meldungen angezeigt.
Wenn für Ihre Abfrage mehr als 1.000 Meldungen zurückgegeben werden, können Sie zum nächsten Datensatz blättern, indem Sie im unteren Bereich des Protokollfensters auf die Schaltfläche Älter klicken. Entsprechend können Sie auch vorwärts blättern, indem Sie auf die Schaltfläche Neuer klicken.
Beim Blättern durch die Datensätze wird das Protokollfenster nicht automatisch aktualisiert. Neue, nach der Abfrage protokollierte Meldungen werden nicht berücksichtigt. Klicken Sie im Modul Protokolle anzeigen auf Abfrage, um die aktuellen Ergebnisse für Ihre Abfrage anzuzeigen.
Anzeigen der Protokolle in einem druckbaren Format
Nachdem Sie eine Abfrage ausgeführt haben, klicken Sie auf den Link Druckansicht, um die Protokolle in einem druckerfreundlichen Format anzuzeigen. Daraufhin wird ein neues Browserfenster (oder eine Registerkarte) mit einer HTML-Anzeige der Protokolle geöffnet. Sie können diese Ansicht verwenden, um die Protokolle auszudrucken, den HTML-Text auf dem Datenträger zu speichern oder die Protokolle zu kopieren und in ein Dokument oder eine Tabellenkalkulation einzufügen. Auf diese Weise können Sie die Protokollmeldungen an andere Mitarbeiter Ihrer Organisation und bei Bedarf an den Support von Esri weitergeben.
In der Druckansicht werden nur die zuletzt ausgeführte Abfrage, die aktuelle Ansicht des Protokollfensters und die von Ihnen festgelegten Protokollierungseigenschaften angezeigt. Wenn Sie die Spalten in der Ereignisprotokollanzeige sortiert oder neu angeordnet haben, wird in der HTML-Ansicht die ursprüngliche Sortierung und Reihenfolge der Spalten, die diese bei der ersten Ausführung der Abfrage hatten, wiederhergestellt. Sie können die Protokolle in eine Tabellenkalkulation kopieren und die Spalten mit den in dieser Anwendung verfügbaren Werkzeugen sortieren und neu anordnen.
Löschen von Protokollen
Klicken Sie auf Protokolle löschen, um die Protokollmeldungen aller Server in der Site zu löschen. Sie werden aufgefordert, das Löschen aller Protokolle zu bestätigen, nachdem Sie auf die Schaltfläche Protokolle löschen klicken.
Beim Debuggen eines bestimmten Szenarios, das Probleme mit dem Server verursacht, kann das Löschen der Protokolle dazu beitragen, das Problem zu identifizieren. Wenn Sie beispielsweise versuchen, die Darstellungs-Performance eines bestimmten Layers in einem Kartenservice zu ermitteln, können Sie das Protokoll löschen, eine Abfrage für die Karte ausführen und das Protokollfenster aktualisieren, um das abgefragte Ereignis anzuzeigen. So werden alle sonstigen Ereignisse aus dem Protokoll entfernt, und Sie können sich auf das Debuggen des Kartenservice konzentrieren.