14.3.7. 在 CLI 里配置 Async 日志处理程序

您可以在 CLI 里添加、删除和编辑异步（Async）日志处理程序。
配置异步日志处理程序的主要任务是：
  • 添加新的 Async 日志处理程序。
  • 显示异步日志处理程序的配置
  • 改变日志级别
  • 设置队列长度
  • 设置溢出动作
  • 添加子处理程序
  • 删除子处理程序
  • 删除异步日志处理程序
每个任务都将在下面进行描述。

重要

当在日志配置集里配置日志处理程序时，配置路径的根目录是 /subsystem=logging/logging-profile=NAME/ 而不是/subsystem=logging/。
添加新的 Async 日志处理程序。
使用 add 操作和下列语法。 
 /subsystem=logging/async-handler=HANDLER:add(queue-length="LENGTH")
用文件日志处理程序的名称替换 HANDLER，并用保持在队列里的日志请求的最大数目替换 LENGTH。

例 14.51. 

[standalone@localhost:9999 /] /subsystem=logging/async-handler=NFS_LOGS:add(queue-length="10")
{"outcome" => "success"}
显示异步日志处理程序的配置
使用 read-resource 操作和下列语法。 
 /subsystem=logging/async-handler=HANDLER:read-resource
用文件日志处理程序的名称替换 HANDLER。

例 14.52. 

[standalone@localhost:9999 /] /subsystem=logging/async-handler=NFS_LOGS:read-resource
{
    "outcome" => "success",
    "result" => {
        "encoding" => undefined,
        "filter" => undefined,
        "formatter" => "%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n",
        "level" => undefined,
        "overflow-action" => "BLOCK",
        "queue-length" => "50",
        "subhandlers" => undefined
    }
}
[standalone@localhost:9999 /]
改变日志级别
请使用 write-attribute 命令和下列语法。 
 /subsystem=logging/async-handler=HANDLER:write-attribute(name="level", value="LOG_LEVEL_VALUE")
用日志处理程序的名称替换 HANDLER，并用日志级别替换 LOG_LEVEL_VALUE。

例 14.53. 

[standalone@localhost:9999 /] /subsystem=logging/async-handler=NFS_LOGS:write-attribute(name="level", value="INFO")
{"outcome" => "success"}
[standalone@localhost:9999 /]
设置队列长度
请使用 write-attribute 命令和下列语法。 
 /subsystem=logging/async-handler=HANDLER:write-attribute(name="queue-length", value="LENGTH")
用文件日志处理程序的名称替换 HANDLER，并用保持在队列里的日志请求的最大数目替换 LENGTH。
重启 JBoss EAP 6 服务器以使修改生效。

例 14.54. 

[standalone@localhost:9999 /] /subsystem=logging/async-handler=NFS_LOGS:write-attribute(name="queue-length", value="150")
{
    "outcome" => "success",
    "response-headers" => {
        "operation-requires-reload" => true,
        "process-state" => "reload-required"
    }
}
设置溢出动作
请使用 write-attribute 命令和下列语法。 
 /subsystem=logging/async-handler=HANDLER:write-attribute(name="overflow-action", value="ACTION")
用文件日志处理程序的名称替换 HANDLER，并用 DISCARD 或 BLOCK 替换 ACTION。

例 14.55. 

[standalone@localhost:9999 /] /subsystem=logging/async-handler=NFS_LOGS:write-attribute(name="overflow-action", value="DISCARD")
{"outcome" => "success"}
[standalone@localhost:9999 /]
添加子处理程序
使用 add-handler 操作和下列语法。 
 /subsystem=logging/async-handler=HANDLER:add-handler(name="SUBHANDLER")
用文件日志处理程序的名称替换 HANDLER，并用将被添加为子处理程序的日志处理程序的名称替换 SUBHANDLER。

例 14.56. 

[standalone@localhost:9999 /] /subsystem=logging/async-handler=NFS_LOGS:add-handler(name="NFS_FILE")       
{"outcome" => "success"}
[standalone@localhost:9999 /]
删除子处理程序
使用 remove-handler 操作和下列语法。 
/subsystem=logging/async-handler=HANDLER:remove-handler(name="SUBHANDLER")
用文件日志处理程序的名称替换 HANDLER，并用要删除的子处理程序的名称替换 SUBHANDLER。

例 14.57. 

[standalone@localhost:9999 /] /subsystem=logging/async-handler=NFS_LOGS:remove-handler(name="NFS_FILE")       
{"outcome" => "success"}
[standalone@localhost:9999 /]
删除异步日志处理程序
使用 remove 操作和下列语法。 
/subsystem=logging/async-handler=HANDLER:remove
用文件日志处理程序的名称替换 HANDLER。

例 14.58. 

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