Event log

PI Integrator for Esri ArcGIS records certain events to an event log which you can use to troubleshoot the software.

PI Integrator for Esri ArcGIS software might display a warning ribbon to alert you to check the event log. The warning ribbon displays when any error with severity of Warning or higher has occurred within the past 24 hours. You can stop certain warnings from displaying by acknowledging the error from within the event log. Other errors are closed automatically as soon as the error condition is resolved.

Messages of level Debug and higher are logged to files located in C:\ProgramData\OSIsoft\Integrators\Esri\logs. Examine the contents of the directory for more details. Messages of level Information and higher are also logged to the SQL database and are accessible from the Integrator on the log viewer page. The severity levels for the various logs are configured in the OSIsoft.PIGeoServices.SelfHost.exe.config file.

On the log viewer page, several filter fields are populated with default values. You might want to change these values:

• Log level

  Use Log level to filter events that are as severe or more severe than the chosen level. This can eliminate "noise" from the log message if you want to view only events of a certain importance. In order of descending importance, the levels are: Fatal Error, Error, Warning, Information, and Debug.

• Start time and End time

  Start time and End time are specified in any valid PI Time syntax and control the bounds of the log messages returned during search.

• Filter

  Filter allows you to return only log messages which include certain key word(s) in their content.

• Service and Layer

  The search may also be confined to messages that are tied to a specific Service or Layer.

The log entries found by the search also include a Status column. For error conditions that are active-until-closed, the Status column identifies whether the error is Ongoing or Closed. For error conditions that do not signal an ongoing condition (such as a security error encountered by a user), the Status column allows recent messages to be acknowledged by PI Integrator for Esri ArcGIS administrators. The sole effect and purpose of acknowledgement is to suppress the message from triggering an alert banner after administrators become aware of the error. Messages older than one day do not trigger an alert banner and do not require or permit acknowledgement.