Logger Configuration tool

The Logger Configuration tool allows you to manage log settings for the local Workbench. Using the Logger Configuration view you can add and remove log categories and change the applied severity level, which determines the amount of data that is displayed.

Logging is an effective tool for troubleshooting and debugging station communications problems. Each driver and device installed on the connected station has a log category based on its type.

In Niagara 4 logging is handled by the Java.util.logging (JUL) utility which supports multiple concurrent log handlers and provides hierarchical logging support. Also in systems without the Workbench connection, this capability allows you to enable/disable loggers using a web browser.

Logging configuration settings for local or Workbench logs are stored in the !logging/logging.properties file which exists in two locations, your Workbench User Home and the daemon User Home, and are maintained by the framework.

The Logger Configuration tool has seven severity levels which differs from the number of log levels used in NiagaraAX. Log levels used are mapped as shown here:

Table 1. NiagaraAX vs. Niagara 4 Severity Level Mapping
NiagaraAX Log Levels	Niagara 4 Log Levels
	Off
Error	Severe
Warning	Warning
Message	Info
	Config
Trace	Fine
	Finer
	Finest
	All

The Logger Configuration view is the main view for the Logger Configuration tool, as well as for the station DebugService.

Logs for the connected station are visible in the platform Application Director view. While logs for Workbench are visible in the Niagara console started with Workbench.

The logs are persisted each time they are changed, since the changes are saved to the logging.properties file.

The ROOT log category is essentially a default log level. If any log is set to severity log level default, it uses the same configured severity level selected for the Root of that particular log. For example, the following diagram setting alarm to the default log level means that the alarm log level has been set to warning (the configured level of default row).

Both Local (Workbench ) Spy and Remote ( Station ) Spy can be accessed via Workbench by right-clicking the station in the Nav tree. Only Remote ( Station ) Spy can be accessed via a web browser using the url :http(s)://<ip address>:<port number>/ord?spy: