如何在Ballerina REST API项目中配置启用调试日志？

1. 配置日志级别以启用调试日志 #

有两种常用方式可以将日志级别设置为DEBUG：

方式一：静态配置（永久生效） #

在项目根目录的Ballerina.toml中添加日志配置块，指定全局日志级别为DEBUG：

[ballerina.log]
level = "DEBUG"

保存文件后重启服务，即可输出所有DEBUG及以上级别的日志（包含INFO、WARN、ERROR）。

方式二：运行时动态指定（临时生效） #

如果不想修改项目配置文件，可在启动服务时通过JVM参数临时设置日志级别：

bal run --jvm -Dballerina.log.level=DEBUG your-rest-service.bal

这种方式仅对当前运行的服务实例生效，不会改动项目配置文件。

2. 需要修改的特定配置文件或设置 #

• 核心配置文件：Ballerina.toml，这是Ballerina项目的全局配置文件，存放在项目根目录。通过修改该文件中的[ballerina.log]配置块，可永久设置全局日志级别。
• 模块级可选配置：
  若只需针对特定模块开启调试日志（比如仅启用REST API业务模块的调试输出），可在Ballerina.toml中添加模块级日志配置：

  [[ballerina.log.module]]
  name = "your.custom.module"
  level = "DEBUG"
  

  将your.custom.module替换为实际的模块名称即可。

另外，若项目中使用log模块自定义了日志逻辑，需确保代码中没有硬编码覆盖全局日志级别，否则需同步调整代码内的日志级别设置。

内容的提问来源于stack exchange，提问作者Chiran Sachintha