OMNIA 3 Connector Logging

1. Logging configuration

The precision of logs generated on Omnia Connector can be configured.

There are six different log levels:

  • Verbose
  • Debug
  • Information
  • Warning
  • Error
  • Fatal

The pre-defined minimum log level on Omnia Connector is Information. This means that all messages of level Information and above will be logged.

A different minimum log level can be defined on Connector configuration file(config.json), and it is also possible to change the path of the log files. Example:

    "Logging": {
        "MinimumLevel": "Debug",
        "File": {
            "Path": "C:/users/myUser/Desktop"
        }
    }

2. Write to log files

See how you can write to log files on your behaviours here.

3. Obtaining the logs

There are three different logs being produced when you run the connector: the connector itself’s logs, the behaviour manager’s, and the behaviour server’s. To understand what these three different softwares do, please read this page.

Each of them will output their logs into the log folder configured by the user, following the same logging logic as the rest of the platform: a file prefixed by the date, such as 20180606-behavioursserver.log. These files will be automatically split when they become too large.

Where to find the log files?

The default locations are:

  • Connector logs: %temp%\omnia\

Note: if the Connector is running in the context of Local System user, the Temp folder of that user is: C:\Windows\Temp\omnia

4. Analyzing the logs

To analyze these logs, we recommend using a tool such as Notepad++, due to their potentially large file size and contents.

By default, they will be present in the temporary folder of your system, under an “omnia” folder, i.e., %temp%/omnia on Windows.