The On Premise Engine has a variety of logging options to enable detecting errors and diagnosing issues.

Logging Configuration

  "Logging": {
    // Log level options are:
    // Trace, Debug, Information, Warning, Error, Critical
    // Trace = Very verbose and some more sensitive data is logged like the details of what is sent to the cloud API. Probably only want to use with the Console option.
    // Debug = Verbose but not as much as Trace. Good for debugging.
    // Information = Normal logging level. Good for most installations.
    // Warning = Only logs warnings and errors. Suggested for EventLog.
    "Console": {
      "LogLevel": {
        "Default": "Debug",
        "Microsoft": "Warning"
      }
    },
    "EventLog": {
      "LogLevel": {
        "Default": "Warning",
        "OnPremEmailFetcher.EmailFetcher.Program": "Debug",
        "OnPremEmailFetcher.EmailFetcher.EmailFetcherFactory": "Debug",
        "OnPremEmailFetcher.EmailFetcher.EmailFetcherEngine": "Debug",
        "OnPremEmailFetcher.EmailFetcher.Exporters.SigParserApiExporter": "Information"
      }
    },
    "SignalR": {
      "HubUrl": "wss://ipaas.sigparser.com/api...",
      "LogLevel": {
        "Default": "Information",
        "Microsoft": "Warning",
        "Microsoft.Hosting.Lifetime": "Information"
      }
    }
  }

What gets logged?

Enough information will be logged to diagnose issues. When full logging is enabled the following details are logged:

Severity levels of logs
Timestamps
Mailbox (email address) being processed
Environment settings (Processor count, non-secret configuration options)
ID of objects processed
Delta tokens used for keeping track of where it left off
Email Folder an email came from - Useful when customers have questions about whether a folder was seen or not.
Date of emails or meetings (possibly)

What isn't logged

The default is that we log everything down to the Debug level (does not include body content or the subject lines, email signatures or raw contact details).

If you need to see the contents of what is sent, you can enable Trace-level logging via the appsettings.json file; see Logging Configuration above (would likely include body content or the subject lines, email signatures or raw contact details).

Where logs are sent

Logs entries are sent to the log configuration providers - see Logging Configuration above.

If you have any questions, send us an email at support@sigparser.com. You can also book a demo session HERE.