14.3.3. 在 CLI 里配置控制台日志处理程序

您可以在 CLI 里添加、删除和编辑日志处理程序。
配置控制台日志处理程序的主要任务是：
  • 添加新的控制台处理程序
  • 显示控制台日志处理程序的配置。
  • 设置处理程序的日志级别。
  • 设置用于处理程序输出的目标。
  • 设置用于处理程序输出的编码。
  • 设置用于处理程序输出的格式器。
  • 设置处理程序是否使用自动冲刷。
  • 删除控制台日志处理程序。

重要

当在日志配置集里配置日志处理程序时，配置路径的根目录是 /subsystem=logging/logging-profile=NAME/ 而不是/subsystem=logging/。
添加控制台处理程序
请使用 add 操作和下列语法，用要添加的日志处理程序的名称替换 HANDLER。 
/subsystem=logging/console-handler=HANDLER:add

例 14.12. 添加控制台处理程序

[standalone@localhost:9999 /] /subsystem=logging/console-handler=ERRORCONSOLE:add     
{"outcome" => "success"}
显示控制台日志处理程序的配置
请使用 read-resource 命令和下列语法。用日志处理程序的名称替换 HANDLER。 
/subsystem=logging/console-handler=HANDLER:read-resource

例 14.13. 显示控制台日志处理程序的配置

[standalone@localhost:9999 /] /subsystem=logging/console-handler=CONSOLE:read-resource
{
    "outcome" => "success",
    "result" => {
        "autoflush" => true,
        "enabled" => true,
        "encoding" => undefined,
        "filter" => undefined,
        "filter-spec" => undefined,
        "formatter" => "%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n",
        "level" => "INFO",
        "name" => "CONSOLE",
        "named-formatter" => "COLOR-PATTERN",
        "target" => "System.out"
    }
}
设置日志级别
请使用 write-attribute 命令和下列语法。用控制台日志处理程序的名称替换 HANDLER，并用日志级别替换 LEVEL。 
/subsystem=logging/console-handler=HANDLER:write-attribute(name="level", value="INFO")

例 14.14. 设置日志级别

[standalone@localhost:9999 /] /subsystem=logging/console-handler=ERRORCONSOLE:write-attribute(name="level", value="TRACE")
{"outcome" => "success"}
设置目标
请使用 write-attribute 命令和下列语法。用控制台日志处理程序的名称替换 HANDLER，用分别代表标准错误流和标准输出流的 System.err 或 System.out 替换 TARGET。 
/subsystem=logging/console-handler=HANDLER:write-attribute(name="target", value="TARGET")

例 14.15. 设置目标

[standalone@localhost:9999 /] /subsystem=logging/console-handler=ERRORCONSOLE:write-attribute(name="target", value="System.err")
{"outcome" => "success"}
设置编码
请使用 write-attribute 命令和下列语法。用控制台日志处理程序的名称替换 HANDLER，并用所需的字符编码系统替换 ENCODING。 
/subsystem=logging/console-handler=HANDLER:write-attribute(name="encoding", value="ENCODING")

例 14.16. 设置编码

[standalone@localhost:9999 /] /subsystem=logging/console-handler=ERRORCONSOLE:write-attribute(name="encoding", value="utf-8")     
{"outcome" => "success"}
设置格式器
请使用 write-attribute 命令和下列语法。用控制台日志处理程序的名称替换 HANDLER，并用格式器字符串替换 FORMAT。 
/subsystem=logging/console-handler=HANDLER:write-attribute(name="formatter", value="FORMAT")

例 14.17. 设置格式器

[standalone@localhost:9999 /] /subsystem=logging/console-handler=ERRORCONSOLE:write-attribute(name="formatter", value="%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n")
{"outcome" => "success"}
设置自动冲刷
请使用 write-attribute 命令和下列语法。用控制台日志处理程序的名称替换 HANDLER。如果处理程序立即写入到输出，则用 true 替换 BOOLEAN。 
/subsystem=logging/console-handler=HANDLER:write-attribute(name="autoflush", value="BOOLEAN")

例 14.18. 设置自动冲刷

[standalone@localhost:9999 /] /subsystem=logging/console-handler=ERRORCONSOLE:write-attribute(name="autoflush", value="true")                                  
{"outcome" => "success"}
删除控制台日志处理程序
请使用 remove 命令和下列语法。用要删除的日志处理程序的名称替换 HANDLER。 
/subsystem=logging/console-handler=HANDLER:remove

例 14.19. 删除控制台日志处理程序

[standalone@localhost:9999 /] /subsystem=logging/console-handler=ERRORCONSOLE:remove
{"outcome" => "success"}
提交 bug 报告