Skip To Content

Monitoring logs

ArcGIS GeoEvent Server has logging capabilities that allow you to monitor the server site. This includes configuring the message logging, filtering and searching of the logs, debugging certain components. Access the GeoEvent Server logs from the Logs tab in ArcGIS GeoEvent Manager.

Log messages in ArcGIS GeoEvent Manager.

Filtering and searching logs

GeoEvent Server provides the ability to query the available log messages with filter and search capabilities. The log messages can be filtered by clicking the Log Filter drop-down where you can choose among the five message types including Trace, Debug, Info, Warn, and Error. To narrow the query even more you can enter keywords into the text field to the right of the Log Filterdrop-down.

GeoEvent Server keeps a selection of the most recent logs in memory and is constantly refreshing its cache. When troubleshooting an issue, you will often want to open the actual log file in a text editor to perform a full text search. The log file can be found with the other runtime files beneath data folder in the installation directory: <ArcGIS Server installation directory>\GeoEvent\data\log\karaf.log.

Debug log messages

Every component in GeoEvent Server is associated with a specific logger. For example, the com.esri.ges.transport.featureService.FeatureServiceOutboundTransportlogger is associated with the transport which requests a feature service add or update feature records in a geodatabase's feature class.

To enable debug logging for a component, click Logs > Settings and either use the drop-down to select the appropriate logger from the list or enter the logger's name into the text field on the Log Settingsdialog.

Log Settings dialog that allows you to specify the log level and logger for creating log messages.

You can force a refresh of the logger's drop-down selection list by temporarily setting DEBUG on ROOT and allowing GeoEvent Server to ingest, process, and disseminate several event records. Just be sure to set the ROOT logger back to INFO before proceeding to enable debug logging on a specific logger.

Configuring message logging

GeoEvent Server uses the Log4J Logger API for logging messages. Pax Logging supports Log4J with integration for the OSGi framework (GeoEvent Server uses this framework for developing and deploying its Java bundles). The org.ops4j.pax.loggingproject on GitHub implements the OSGi Logging framework.

GeoEvent Server message logging can be configured by editing the org.ops4j.pax.logging.cfg file located (on a Windows system) beneath <ArcGIS Server installation directory>\GeoEvent\etc.

The maximum size of the karaf.log file at <ArcGIS Server installation directory>\GeoEvent\data\log, the number of rollover files kept, and the format of the logged messages, are all configured within the org.ops4j.pax.logging.cfg file.

For example, you can edit the log4j.appender.out.maxFileSize configuration file to and update the default (1MB) max file size to allow for larger log files, or change the log4j.appender.out.maxBackupIndex file to specify that more message log files be kept when the main log file's maximum size is reached and is rolled to an archive file. Simple settings such as these can be important if a high volume or high velocity of real-time event data is creating a large amount of log messages.