This package provides a basic API for logging.
A log record contains the timestamp, log level, module name, and the log message.
Users can pass any number of key/value pairs which needs to be displayed in the log message.
These can be of
anydata type including int, string and boolean.
A sample log record logged from the
foo module would look as follows:
1time = 2020-12-16 11:22:44,029 level = ERROR module = myorg/foo message = "Something went wrong."
Logs are written to the
stderr stream (i.e., the console) by default in order to make the logs more container friendly.
To publish the logs to a file, redirect the
stderr stream to a file.
1$ ballerina run program.bal 2> b7a-user.log
To set the output format to JSON, place the entry given below in the
1[ballerina.log]2format = "json"
This package provides functions to log at four levels, which are
WARN. By default, all log messages are logged to the console at the
The log level can be configured via a Ballerina configuration file. To set the global log level, place the entry given below in the Config.toml file:
1[ballerina.log]2level = "[LOG_LEVEL]"
Each module can also be assigned its own log level. To assign a log level to a module, provide the following entry in the Config.toml file:
1[[ballerina.log.modules]]2name = "[ORG_NAME]/[MODULE_NAME]"3level = "[LOG_LEVEL]"
For information on the operation, which you can perform with this package, see the below Function. For examples on the usage of the operation, see Log Api.
Prints debug logs.
Prints error logs.
Prints info logs.
Prints warn logs.
Key-Value pairs that needs to be desplayed in the log.
A value of anydata type
A function that returns anydata type