Please activate JavaScript!
Please install Adobe Flash Player, click here for download

arcAKTUELL 3.2012 - Reale und virtuelle Infrastrukturen

Der ArcGIS Server protokolliert automatisch alle wesentlichen Ereignisse. Die dabei entstehenden Protokolle sind ein mächtiges Hilfsmittel, um die Ursache eines unerwünschten und möglicherweise fehlerhaften Ver- haltens einzugrenzen. Dieser Artikel gibt einen Einblick in den Protokol- lierungsmechanismus von ArcGIS Server 10.1 und stellt Werkzeuge vor, die die komfortable Analyse von Protokollen ermöglichen. Wie die Protokollierung funktioniert Die neue Architektur von Version 10.1 des ArcGIS Servers bringt Neue- rungen in der Protokollierung mit sich. So protokollierte beispielsweise bis ArcGIS Server 10.0 ein zentraler ArcSOC-Monitorprozess die Mel- dungen aller beim Server Object Manager registrierten Container- Maschinen und speicherte sie zentral ab. Im Gegensatz dazu schreibt in Version 10.1 jede Maschine, die zu einer ArcGIS Server Site gehört, ein separates Protokoll pro GIS-Service und zusätzlich eines mit Einträ- gen, die das Server-Framework betreffen. Es entstehen also auf jeder Server-Maschine mehrere Protokolldateien. Analyse in einem Texteditor Manchmal findet man eine Fehlermeldung in den Logfiles mithilfe ei- nes Texteditors. Man benötigt dazu allerdings Zugriff auf die Verzeich- nisse mit den Protokolldateien und einen guten Verdacht, was die Feh- lerquelle betrifft. Wenn hingegen nicht klar ist, welche Maschine und welcher Service betroffen ist, oder wenn die relevanten Protokolleinträ- ge in einer Flut von weiteren Meldungen untergehen, greift man gern auf Werkzeuge mit besseren Filterfunktionen zurück. Analyse mittels ArcGIS Server Manager Das naheliegendste Werkzeug für die Analyse von Protokollen ist der ArcGIS Server Manager. Im Manager lassen sich die Protokolleinträge einer Site über verschiedene Drop-down-Menüs filtern. Ausserdem kann man einstellen, welche Eigenschaften eines Ereignisses angezeigt werden sollen: beispielsweise der Zeitpunkt eines Fehlers, dessen Quelle, die Fehlermeldung und der zugehörige Fehlercode. » Abbil- dung 1 zeigt die Anzeige von Protokolleinträgen im Manager. Manchmal erleichtert es dem Nutzer die Arbeit, wenn er ein Protokoll aus der Druckansicht des Managers per Copy/Paste in ein MS-Excel- Arbeitsblatt übernimmt. MS Excel bietet zusätzliche Möglichkeiten zur Filterung der Daten und zur Erstellung eines formatierten Berichts. Bei der Arbeit mit dem ArcGIS Server Manager ist es interessant zu wis- sen, dass er im Hintergrund immer über das REST Admin API mit dem ArcGIS Server kommuniziert. Das REST Admin API ist eine mit Version 10.1 neu eingeführte Programmierschnittstelle für die Administration von ArcGIS Server Sites. Der Bereich der Protokollierung ist dabei nur ein kleiner Teil des gesamten Funktionsumfangs. Das Admin API lässt sich nicht nur aus dem Manager heraus nutzen, sondern grundsätzlich mit jedem HTTP Client. Die ArcGIS Server REST Admin Konsole unter- stützt Sie dabei, solche Anfragen zu formulieren. ArcGIS Server REST Admin Konsole Melden Sie sich dazu an der REST Admin Konsole (http://: 6080/arcgis/admin) an und navigieren Sie nach ../logs/query. Vergleich- bar mit dem Manager lassen sich dort Filterkriterien über ein Drop- down-Menü einstellen. Alternativ steht ein Freitextfeld zur Verfügung, das die Eingabe komplexerer Filterkriterien im JSON-Format ermög- Analyse von ArcGIS 10.1 for Server Protokollen (Logfiles) TIPPS UND TRICKS FÜR ANWENDER 49T I P P S U N D T R I C K S licht. » Abbildung 2 zeigt die Admin Konsole mit einem Beispiel einer solchen Abfrage. Das Abfrageergebnis wird als HTML-Tabelle, XML oder JSON im Browser angezeigt. Automatisierung mittels Skript und Model Builder Anstatt via Manager oder REST Admin Konsole lässt sich das Admin API auch in Skripten einsetzen. Die periodische Abfrage und leserfreund- liche Aufbereitung bestimmter Protokollinformationen kann auf diesem Weg weitgehend automatisiert werden. Python-Beispiele in der ArcGIS Dokumentation illustrieren die Abfrage von Protokollen sowie die Ab- leitung von Nutzungs- und Leistungsstatistiken. Der Einsatz von Python hat gegenüber anderen Skriptsprachen den Vorteil, dass sich Python-Skripte besonders gut ins Geoverarbeitungs- framework von ArcGIS integrieren lassen. Schauen Sie sich in diesem Zusammenhang die erweiterbaren Werkzeuge im „ArcGIS Server Ad- ministration Toolkit – 10.1“ an. Sie finden dieses Toolkit auf der ArcGIS Online Website. Marcel Frehner Esri Schweiz AG Zürich http://resources.arcgis.com/en/help/main/10.1/#/Example_Derive_map_service_statistics_ from_the_ArcGIS_Server_logs/0154000005vw000000/ http://www.arcgis.com/home/item.html?id=12dde73e0e784e47818162b4d41ee340 ++ 1 Protokolle im ArcGIS Server Manager 2 Protokollabfrage in der ArcGIS Server REST Admin Konsole

Seitenübersicht