|Logger||Name of the logger that describes the context of the message.|
|Time||Time of log.|
|Message||Message for the log.|
Search criteria to filter for specific tasks or events. Click the Calendaricon to set a filter date and time range. Options are Last Month, Last Week, Last 24 Hours, or Custom.
|Min Level||Dropdown menu with options: All, Trace, Debug, Info, Warn and Error.|
|Live Values||Toggle switch to turn live values on or off.|
Changing Logging Levels
The logs can be filtered by using a search term or by date.
- To change logging levels, go to the Gateway's Status > Diagnostics > Logs page and click on the Settings icon.
- On the Log Configuration popup that will open, search for the logger name in the Filter box, and select the desired logging level from the dropdown to the right of the logger name
Downloading the Logs
Gateway logs can also be exported using the Download Logsicon the right.
Printing to the Logs
Mapped Diagnostic Context Keys
Mapped Diagnostic Context Keys (MDC Keys) allow you to specify a specific context, such as a particular project, and then set a logging level for it. This will set all loggers that pertain to the specified project to the logging level. This is useful to help diagnose an issue with a specific system within the Gateway. To use MDC Keys, click the Settingsicon on the Logs page and navigate to the Context tab. Here, you can choose specific Key-Value pairs that match a particular system. Selecting the Key text field will bring up a list of possible keys in your system. Once a Key has been selected, selecting the Value text field will bring up a list of possible values that relate to the selected Key.
Filter by Mapped Diagnostic Context Key
The Logs can also be filtered to show only logs that pertain to an MDC Key. This can be useful when altering the logging level of one or more MDC Keys. To set an MDC filter on the logs, simply click the Add Mapped Diagnostic Context Filtericon on the Logs page to open a window where MDC Key filters can be set. The filter can be specified for all values in a Key by not specifying a Value.
Merging to Logs
Many of the other pages in the Status tab also contain a logger that will just show logs that are relevant for that particular section. These log views all contain a button on the right side called Merge to Logs. This button allows the current filter to be applied to the main logs page, allowing you to still see only the logs for that section but use all of the tools available.