Logging

Common information

Serilog is used for logging. Configuration is done in appsettings.json. See Serilog's documentation for further information.

The default settings will create a Logs sub-folder in the Connector service's application path and store log-files there on a per-day file basis. The pattern for the default log file name is "cpm-service-intrafind-connector-log-YYYYMMDD.txt".

  • Default log level is INFORMATION .
  • Log level DEBUG gives detailed information in case of problems.
  • Log level VERBOSE is for tracing problems and may slow down the hosting system. It should not be left at this value without good reason.

You can get a live view of today's current log file using:

Copy
Copied
powershell gc -wait [logfile]

See Serilog's documentation on how to set up notifications for log file errors. For example, e-mail notification can be done by the e-mail sink.

Errors

"Event 'Elements have changed' but connection-state is invalid: [ConnectionState]. Stopping further processing."

The microservice received a changed-event, but the Celonis Process Management's REST API is not available for the stated reason.

  • Check "external system configuration".
  • Try to unlink and re-link again.
  • Check for previous errors in the log file.

Fatal, unrecoverable errors

"Unexpected exception during crawling occurred, stopping."

An unrecoverable fatal error occured during a full-fetch session. Processing was interrupted, and the Intrafind documents and Celonis Process Management elements are not in sync.

Information may be deleted from the Intrafind document store, until another full-fetch run is successfully completed.

"Trying to access Celonis Process Management Api with invalid connection data"

  • Check the Intrafind Connector service installation and configuration.
  • Try to unlink and link again to storage.
  • Check microservice's database settings.

"Token role invalid, please check Celonis Process Management configuration"

  • Check the access token configuration in Celonis Process Management.
  • Is a proper token role selected in "external system configuration"?

"No activated token role given, please check Celonis Process Management configuration"

  • Check access token configuration in Celonis Process Management.
  • Is a proper token role selected in "external system configuration"?

"Could not parse custom attribute '[name]' from ExternalSystem data"

Check the referenced custom attribute in "external system configuration".

"Token role is '[...]', need at least 'Viewer'-role. Please check Celonis Process Management configuration"

Token role 'access' was given.

  • Check access token configuration in Celonis Process Management.
  • Is a proper token role selected in "external system configuration"?