esri / systemlogparser

A reporting tool specifically designed for analyzing ArcGIS server and service logs to help quantify the GIS usage in the deployment

System Log Parser

Version 0.13.0.1

Date: 2024/06/14

---

Download Latest Release

System Log Parser Download

---

Description

System Log Parser is an ArcGIS for Server (10.1+) log query and analyzer tool to help you quickly quantify the GIS usage in your deployment. When run, it connects to an ArcGIS for Server instance on port 443/6443/6080/80 as a publisher (or an administrator), retrieves the logs from a time duration (specified as an input), analyzes the information then produces a spreadsheet version of the data that summarizes the service statistics. However, System Log Parser can also read access logs from other sources such as: Microsoft IIS, Apache Tomcat, Amazon ELB/ALB, Amazon CloudFront and Microsoft Azure.

System Requirements

• 64bit Windows Operating System:

  • Windows (Workstation): 7, 8*, 8.1**, 10**, 11**
  • Windows (Server): 2008, 2012, 2016, 2019, 2022

• Processor: AMD64/Intel64

• RAM: 8GB

• Disk Space: 2GB free when using the new Optimized Analysis Type

• Security Protocol***: TLS 1.0, TLS 1.1, TLS 1.2, or TLS 1.3

• Microsoft .NET Framework 4.8 (Full)

• Publisher (or administrative) access to ArcGIS Server's REST API Admin endpoint in order to query the logs

• ArcGIS Server log level set to FINE (from within the ArcGIS Server Manager) before using this tool

• A deployment running ArcGIS Server 10.1 or higher

• If performing Web (IIS) log analysis, it is recommended to have the Log File Rollover Schedule set to Hourly or Daily (from the Internet Information Services Manager)

• *If using Windows 8, .NET Framework 3.5 (in addition to 4.8) must be enabled per Microsoft documentation

• **If using Windows 8.1 or greater, the .NET Framework 3.5 (in addition to 4.8) must be enabled per Microsoft documentation

• ***Not relevant if logs are consumed directly from the file system (e.g. reading the local disk or via CIFS share)

System Recommendations:

• Microsoft Excel 2010 or higher (or appropriate xlsx viewer)
• RAM: 16GB
• Disk Space: 6GB free when using the new Optimized Analysis Type
• Security Protocol*: TLS 1.2 or TLS 1.3
• If performing Microsoft IIS log analysis, it is recommended to have the Log File Rollover Schedule set to Hourly (from the Internet Information Services Manager); Hourly creates more, smaller files but allows for a finer grain search
• If querying through the web, an user with administrative access is recommended as they can gather details on all service types
• *Not relevant if logs are consumed directly from the file system (e.g. reading the local disk or via CIFS share)

---

How To Download System Log Parser

• Download the latest release here: System Log Parser Download and unzip it to your local workstation
• System Log Parser does not include an installer.

---

How To Use System Log Parser

Once the System Log Parser is downloaded and unzipped, launch the GUI by double-clicking on SystemLogsGUI.exe The most common scenario for using System Log Parser is to point it at an ArcGIS Server to analyze the logs:

• Once the this has launched, select the ArcGIS Server (Web) tab from the top
• Fill out the necessary information like Server URL and Authentication details
• Click Analyze
• System Log Parser will connect to ArcGIS Server to retrieve and analyze the logs, then produce a spreadsheet report
• The log retrieval make take a few moments, depending on the size of the ArcGIS Server logs
• The generated report can be used to help quantify the GIS usage of the Site by providing a breakdown of what services users are requesting and how long they are waiting for the response

Note: the ArcGIS Server LogLevel must be set to Fine when performing ArcGIS Server (Web) analysis

---

Esri Community Articles on System Log Parser for Specific Scenarios

• ArcGIS Enterprise Analysis with System Log Parser's Optimized Analysis Type
• Automating System Log Parser from the Windows Command Line
• ArcGIS Enterprise Analysis with System Log Parser's ServiceDetails Analysis Type
• System Log Parser - Statistics and Service Optimization
• ArcGIS Server Tuning and Optimization with System Log Parser

---

License

System Log Parser is released under: CC BY-NC-SA 4.0

• https://creativecommons.org/licenses/by-nc-sa/4.0/
• https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode.en

---

Support Status

System Log Parser is not a supported tool

---

ChangeLog

ChangeLog details

systemlogparser's Issues

Service level javaHeapSize configuration not captured in Enhanced Site Report

I love the ESR function to capture a snapshot of site configuration. However, it does not include the optional service level javaHeapSize which can be configured (see Esri docs)

Source Code

Could you please make the source code available? This would be great!

Linux Support

Hello! I would like to inquire if there are any future plans to support the System Log Parser installation on Linux? Thank you!

Group all "Query" operations in the statistics

Would it be possible to group all of the requests to the "query" operation? Currently, layer numbers interfere with the grouping of query operations.

json report type

when I use JSON as report type, the JSON content would be printed in terminal but no json file is created. Is it normal?

Windows Defender High CPU/CLI Command Doesn't Finish

I have setup SLP to run via command line automatically on my workstation once a week. I am trying to move this process to a server but it never seems to finish running. Looking at Task Manager on this server the Antimalware Service Executable (Windows Defender Service) has constant high CPU utilization. Most times it's greater than 15% but can jump up to over 50%. It takes about 15 minutes to run on my workstation, I usually cancel the script at about an hour of running. I have added my custom download directory, installation directory, and script directory as exclusions in the Windows Defender excluded folders.

Documentation doesn't seem to work

We're using the Version 0.12.20.0 release. We can open the help (from the link in the GUI). The TOC displays but none of the content displays. We're interested in the command-line documentation in particular. But, a working Help system (or one that works for us) would be helpful (see what I did there?) ;-)