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"?