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 /]
