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:
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”?