日志记录器（loggers）
loggers 端点提供对应用程序日志记录器及其日志级别配置的访问。
检索所有日志记录器
要获取应用程序的日志记录器，请向 GET 发送一个 /actuator/loggers 请求，如下列基于 curl 的示例所示：
$ curl 'http://localhost:8080/actuator/loggers' -i -X GET生成的响应类似于以下内容：
HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 791
{
"levels" : [ "OFF", "FATAL", "ERROR", "WARN", "INFO", "DEBUG", "TRACE" ],
"loggers" : {
"ROOT" : {
"configuredLevel" : "INFO",
"effectiveLevel" : "INFO"
},
"com.example" : {
"configuredLevel" : "DEBUG",
"effectiveLevel" : "DEBUG"
}
},
"groups" : {
"test" : {
"configuredLevel" : "INFO",
"members" : [ "test.member1", "test.member2" ]
},
"web" : {
"members" : [ "org.springframework.core.codec", "org.springframework.http", "org.springframework.web", "org.springframework.boot.actuate.endpoint.web", "org.springframework.boot.web.servlet.ServletContextInitializerBeans" ]
},
"sql" : {
"members" : [ "org.springframework.jdbc.core", "org.hibernate.SQL", "org.jooq.tools.LoggerListener" ]
}
}
}响应结构
响应包含应用程序日志记录器的详细信息。 下表描述了响应的结构：
| 路径 | 类型 | <description> </description> |
|---|---|---|
|
|
日志系统支持的日志级别。 |
|
|
按名称作为键的记录器。 |
|
|
按名称分组的记录器 |
|
|
已配置的日志记录器级别（如果有的话）。 |
|
|
日志记录器的有效级别。 |
|
|
已配置的日志记录器组的级别（如果有的话）。 |
|
|
属于此组的日志记录器 |
获取单个 Logger
要获取单个日志记录器，请向 GET 发送一个 /actuator/loggers/{logger.name} 请求，如下列基于 curl 的示例所示：
$ curl 'http://localhost:8080/actuator/loggers/com.example' -i -X GET前面的示例检索了名为 com.example 的日志记录器的相关信息。
返回的结果类似于以下内容：
HTTP/1.1 200 OK
Content-Disposition: inline;filename=f.txt
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 61
{
"configuredLevel" : "INFO",
"effectiveLevel" : "INFO"
}检索单个组
要检索单个日志组，请向 GET 发起一个 /actuator/loggers/{group.name} 请求，如下列基于 curl 的示例所示：
$ curl 'http://localhost:8080/actuator/loggers/test' -i -X GET前面的示例检索名为 test 的日志记录器组的相关信息。
返回的响应类似于以下内容：
HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 82
{
"configuredLevel" : "INFO",
"members" : [ "test.member1", "test.member2" ]
}设置日志级别
要设置日志记录器的级别，请向 POST 发送一个 /actuator/loggers/{logger.name} 请求，并在 JSON 请求体中指定该日志记录器的配置级别，如下列基于 curl 的示例所示：
$ curl 'http://localhost:8080/actuator/loggers/com.example' -i -X POST \
-H 'Content-Type: application/json' \
-d '{"configuredLevel":"debug"}'前面的示例将 configuredLevel 记录器的 com.example 设置为 DEBUG。
为组设置日志级别
要设置记录器的日志级别，请向 POST 发送一个 /actuator/loggers/{group.name} 请求，并在 JSON 请求体中指定该日志组的配置级别，如下列基于 curl 的示例所示：
$ curl 'http://localhost:8080/actuator/loggers/test' -i -X POST \
-H 'Content-Type: application/json' \
-d '{"configuredLevel":"debug"}'前面的示例将 configuredLevel 日志记录器组的 test 设置为 DEBUG。
清除日志级别
要清除某个日志记录器的级别，请向 POST 发送一个 /actuator/loggers/{logger.name} 请求，并在请求体中包含一个空的 JSON 对象，如下列基于 curl 的示例所示：
$ curl 'http://localhost:8080/actuator/loggers/com.example' -i -X POST \
-H 'Content-Type: application/json' \
-d '{}'前面的示例清除了为 com.example 日志记录器配置的日志级别。