# Working with the Log Level

If no custom log level is set, the default log level will be set by the configuration file.

If the Atlas Copco Data Communication service is restarted then all the current log filters will be removed, leaving only the global filter that was set up by the configuration file.

The log level can be changed while Atlas Copco Data Communication is running, by using the Atlas Copco Data Communication WebAPI.

The following log level system calls are available:

- Endpoint list of all the active log filters

  `GET /DataCommunication/v1/logging`

- Assign a new log level to a specific controller

  `POST /DataCommunication/v1/logging/{logId}/level/{logLevel}`

- Change the global log level for Atlas Copco Data Communication

  `PUT /DataCommunication/v1/logging/global/level/{logLevel}`

- Change the existing log level filter for a controller

  `PUT /DataCommunication/v1/logging/{logId}/level/{logLevel}`

- Reset the log level for the controller. This will revert to use the global log level

  `DELETE /DataCommunication/v1/logging/{logId}`

Log Levels
Log Levels | Description
--- | ---
ERROR | Unhandled exceptions.
WARNING | Handled exceptions or other important events that could caus or indicate out of the ordinary application behavior.
INFORMATION | State changes in the application. Useful for managing application (setup information, service start/stop, controller connected/disconnected).
DEBUG | Information that can be used for debugging purposes (variables, method names).
VERBOSE | Similar to DEBUG but also with full object bodies.

## Communication of Log Id and Internet Protocol Address

The IP address can be found on the interface of the controller or in the log file, when it connects to Atlas Copco Data Communication.

PowerFocus 6000 uses a port number which is created when connecting to Atlas Copco Data Communication. You will find the port number in the log file and not in the controller.

Protocol | Log Id
--- | ---
Open Protocol | Controller IP address
Power Focus 4000 | Controller IP address
Power Focus 6000 | Controller IP address and Port
PowerMAC | Controller IP address
ToolsNet Data Collection Protocol | Controller IP address
ToolsNet Open Protocol | Controller IP address

## Examples of system calls

- Create a filter of the log level for PowerFocus 4000

  `POST /DataCommunication/v1/logging/127.0.0.1/level/verbose`

- Create a filter of the log level for PowerFocus 6000

  `POST /DataCommunication/v1/logging/127.0.0.1:53069/level/verbose`