13.3.2. 在 CLI 里配置日志类别
您可以在 CLI 里添加、删除和编辑日志类别。
配置日志类别的主要任务是:
- 添加新的日志类别。
- 显示日志类别的配置。
- 设置日志级别。
- 在日志类别里添加日志程序。
- 在日志类别里删除日志处理程序。
- 删除日志类别。
重要
当在日志配置集里配置日志类别时,配置路径的根目录是
/subsystem=logging/logging-profile=NAME/ 而不是/subsystem=logging/。
- 添加日志类别
- 请使用
write-attribute命令和下列语法。用日志类别的名称替换 CATEGORY,并用日志级别替换 LEVEL。/subsystem=logging/logger=CATEGORY:add例 13.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例 13.6. 日志类别的 read-resource 操作
[standalone@localhost:9999 /] /subsystem=logging/logger=org.apache.tomcat.util.modeler:read-resource { "outcome" => "success", "result" => { "filter" => 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")例 13.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")例 13.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 /] - 在日志类别里添加日志程序
- 请使用
assign-handler命令和下列语法。用日志类别的名称替换 CATEGORY,并用要添加的处理程序的名称替换 HANDLER。/subsystem=logging/logger=CATEGORY:assign-handler(name="HANDLER")这个日志处理程序必须在添加到 Root Logger 之前必须已被创建。例 13.9. 添加日志处理程序
[standalone@localhost:9999 /] /subsystem=logging/logger=com.company.accounts.rec:assign-handler(name="AccountsNFSAsync") {"outcome" => "success"} [standalone@localhost:9999 /] - 在日志类别里删除日志处理程序
- 请使用
unassign-handler命令和下列语法。用日志类别的名称替换 CATEGORY,并用要删除的处理程序的名称替换 HANDLER。/subsystem=logging/logger=CATEGORY:unassign-handler(name="HANDLER")例 13.10. 删除日志处理程序
[standalone@localhost:9999 /] /subsystem=logging/root-logger=ROOT:root-logger-unassign-handler(name="AccountsNFSAsync") {"outcome" => "success"} [standalone@localhost:9999 /] - 删除类别
- 请使用
remove命令和下列语法。用要删除的日志类别的名称替换 CATEGORY。/subsystem=logging/logger=CATEGORY:remove例 13.11. 删除日志类别
[standalone@localhost:9999 /] /subsystem=logging/logger=com.company.accounts.rec:remove {"outcome" => "success"} [standalone@localhost:9999 /]