Log Management

Downloading Logs

Neuron supports one-click download of all log filed on web pages in version 2.3, as shown below.

The log download function bundles the /neuron/build/logs folder into neuron_logs.tar.gz file and downloads it to a web page. The file contains all the created driver and neuron log files.Directory level examples of files are shown below.

• data-stream-processing.log:data processing configuration;
• dlt645.log:northbound application configuration;
• modbus-plus-tcp.log:sorthbound application configuration;
• neuron.log:log of Neuron.

Set The Debug Log Of The Node

Neuron supports the setting of printing debug logs of a node and automatically switching back to the default log level after approximately ten minutes. The Settings for each node are independent of each other.

Each node’s more operation button has a DEBUG log operation button, as shown below.

When you click this button, a prompt like the one below appears.

In this case, the node starts to print debug logs. You can download the logs about ten minutes later to view the logs of the node, or view the logs under /build/logs.

When the node debug log is printed, the neuron log will also be printed, and the default log level will be automatically switched back after ten minutes.

zlog.conf

Explanation of log configuration file.

[global]
file perms = 666
[formats]
simple = "%d [%V] %f:%L %m%n"
[rules]
*.*     "./logs/%c.log", 50MB * 1 ~ "./logs/%c.#2s.log"; simple

Global

file perms: specify the default access permissions when creating a file.

• 600: only the owner has read and write permissions.
• 644: only the owner has read and write permissions, while group users and other users have only read permissions.
• 700: only the owner has read, write and execute permissions.
• 755: the owner has read, write and execute permissions, while group users and other users have only read and execute permissions.
• 711: the owner has read, write and execute permissions, while group users and other users have only execute permissions.
• 666: all users have read and write permissions for the file.
• 777: all users have read, write and execute permissions.

Formats

Conversion format string: Conversion format string is similar to C’s printf function.

• %d, print the log time;
• %V, log level, in uppercase;
• %f, source code file name;
• %L, source code line number;
• %m, user log, the log entered by the user from the zlog function;
• %n, newline character.

Rules

Rules describe how logs are filtered, formatted, and outputted. Grammar:

(category).(level) (output),(options, optional); (format name, optional)

category

Classification levels.

level

zlog has six default levels: “DEBUG”, “INFO”, “NOTICE”, “WARN”, “ERROR”, “FATAL”. For example, *.DEBUG means any log level greater than or equal to DEBUG will be output.

(output),(options, optional);

[output],[options, optional];

(format name, optional)

[format name, optional]