14.3.2. 在 CLI 里配置日志类别

您可以在 CLI 里添加、删除和编辑日志类别。
配置日志类别的主要任务是：
  • 添加新的日志类别。
  • 显示日志类别的配置。
  • 设置日志级别。
  • 在日志类别里添加日志程序。
  • 在日志类别里删除日志处理程序。
  • 删除日志类别。

重要

当在日志配置集里配置日志类别时，配置路径的根目录是 /subsystem=logging/logging-profile=NAME/ 而不是/subsystem=logging/。
添加日志类别
请使用 write-attribute 命令和下列语法。用日志类别的名称替换 CATEGORY，并用日志级别替换 LEVEL。 
 /subsystem=logging/logger=CATEGORY:add

例 14.5. 添加新的日志类别

[standalone@localhost:9999 /] /subsystem=logging/logger=com.company.accounts.rec:add   
{"outcome" => "success"}
[standalone@localhost:9999 /]
显示日志类别配置
请使用 read-resource 命令和下列语法。用日志类别的名称替换 CATEGORY。 
/subsystem=logging/logger=CATEGORY:read-resource

例 14.6. 日志类别的 read-resource 操作

[standalone@localhost:9999 /] /subsystem=logging/logger=org.apache.tomcat.util.modeler:read-resource
{
    "outcome" => "success",
    "result" => {
        "category" => "org.apache.tomcat.util.modeler",
        "filter" => undefined,
        "filter-spec" => undefined,
        "handlers" => undefined,
        "level" => "WARN",
        "use-parent-handlers" => true
    }
}
[standalone@localhost:9999 /]
设置日志级别
请使用 write-attribute 命令和下列语法。用日志类别的名称替换 CATEGORY，并用日志级别替换 LEVEL。 
/subsystem=logging/logger=CATEGORY:write-attribute(name="level", value="LEVEL")

例 14.7. 设置日志级别

[standalone@localhost:9999 /] /subsystem=logging/logger=com.company.accounts.rec:write-attribute(name="level", value="DEBUG")
{"outcome" => "success"}
[standalone@localhost:9999 /]
设置日志类别以使用 Root Logger 日志处理程序。
请使用 write-attribute 命令和下列语法。用日志类别的名称替换 CATEGORY。根据这个日志类别是否使用 Root Logger 处理程序用 true 替换 BOOLEAN。如果只使用自己分配的处理程序，则用 false 来代替。 
/subsystem=logging/logger=CATEGORY:write-attribute(name="use-parent-handlers", value="BOOLEAN")

例 14.8. 设置 use-parent-handlers

[standalone@localhost:9999 /] /subsystem=logging/logger=com.company.accounts.rec:write-attribute(name="use-parent-handlers", value="true")
{"outcome" => "success"}
[standalone@localhost:9999 /]
在日志类别里添加日志程序
请使用 add-handler 命令和下列语法。用日志类别的名称替换 CATEGORY，并用要添加的处理程序的名称替换 HANDLER。 
/subsystem=logging/logger=CATEGORY:add-handler(name="HANDLER")
这个日志处理程序必须在添加到 Root Logger 之前必须已被创建。

例 14.9. 添加日志处理程序

[standalone@localhost:9999 /] /subsystem=logging/logger=com.company.accounts.rec:add-handler(name="AccountsNFSAsync")
{"outcome" => "success"}
在日志类别里删除日志处理程序
请使用 remove-handler 命令和下列语法。用日志类别的名称替换 CATEGORY，并用要删除的处理程序的名称替换 HANDLER。 
/subsystem=logging/logger=CATEGORY:remove-handler(name="HANDLER")

例 14.10. 删除日志处理程序

[standalone@localhost:9999 /] /subsystem=logging/logger=jacorb:remove-handler(name="AccountsNFSAsync")
{"outcome" => "success"}
[standalone@localhost:9999 /]
删除类别
请使用 remove 命令和下列语法。用要删除的日志类别的名称替换 CATEGORY。 
/subsystem=logging/logger=CATEGORY:remove

例 14.11. 删除日志类别

[standalone@localhost:9999 /] /subsystem=logging/logger=com.company.accounts.rec:remove   
{"outcome" => "success"}
[standalone@localhost:9999 /]
提交 bug 报告