此版本仍在开发中,尚未被视为稳定版本。对于最新的稳定版本,请使用 Spring Boot 3.3.1Spring中文文档

此版本仍在开发中,尚未被视为稳定版本。对于最新的稳定版本,请使用 Spring Boot 3.3.1Spring中文文档

端点提供对应用程序的记录器及其级别配置的访问。loggersSpring中文文档

检索所有记录器

若要检索应用程序的记录器,请向 发出请求,如以下基于 curl 的示例所示:GET/actuator/loggersSpring中文文档

$ curl 'http://localhost:8080/actuator/loggers' -i -X GET

生成的响应类似于以下内容:Spring中文文档

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" ]
    }
  }
}

响应结构

响应包含应用程序记录器的详细信息。 下表描述了响应的结构:Spring中文文档

路径 类型 描述

levelsSpring中文文档

ArraySpring中文文档

日志记录系统支持的级别。Spring中文文档

loggersSpring中文文档

ObjectSpring中文文档

按名称键入的记录器。Spring中文文档

groupsSpring中文文档

ObjectSpring中文文档

按名称键入的记录器组Spring中文文档

loggers.*.configuredLevelSpring中文文档

StringSpring中文文档

记录器的配置级别(如果有)。Spring中文文档

loggers.*.effectiveLevelSpring中文文档

StringSpring中文文档

记录仪的有效水平。Spring中文文档

groups.*.configuredLevelSpring中文文档

StringSpring中文文档

记录器组的配置级别(如果有)。Spring中文文档

groups.*.membersSpring中文文档

ArraySpring中文文档

属于此组的记录器Spring中文文档

路径 类型 描述

levelsSpring中文文档

ArraySpring中文文档

日志记录系统支持的级别。Spring中文文档

loggersSpring中文文档

ObjectSpring中文文档

按名称键入的记录器。Spring中文文档

groupsSpring中文文档

ObjectSpring中文文档

按名称键入的记录器组Spring中文文档

loggers.*.configuredLevelSpring中文文档

StringSpring中文文档

记录器的配置级别(如果有)。Spring中文文档

loggers.*.effectiveLevelSpring中文文档

StringSpring中文文档

记录仪的有效水平。Spring中文文档

groups.*.configuredLevelSpring中文文档

StringSpring中文文档

记录器组的配置级别(如果有)。Spring中文文档

groups.*.membersSpring中文文档

ArraySpring中文文档

属于此组的记录器Spring中文文档

检索单个记录器

要检索单个记录器,请向 发出请求,如以下基于 curl 的示例所示:GET/actuator/loggers/{logger.name}Spring中文文档

$ curl 'http://localhost:8080/actuator/loggers/com.example' -i -X GET

前面的示例检索有关名为 的记录器的信息。 生成的响应类似于以下内容:com.exampleSpring中文文档

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"
}

响应结构

响应包含所请求的记录器的详细信息。 下表描述了响应的结构:Spring中文文档

路径 类型 描述

configuredLevelSpring中文文档

StringSpring中文文档

记录器的配置级别(如果有)。Spring中文文档

effectiveLevelSpring中文文档

StringSpring中文文档

记录仪的有效水平。Spring中文文档

路径 类型 描述

configuredLevelSpring中文文档

StringSpring中文文档

记录器的配置级别(如果有)。Spring中文文档

effectiveLevelSpring中文文档

StringSpring中文文档

记录仪的有效水平。Spring中文文档

检索单个组

要检索单个组,请向 发出请求, 如以下基于 curl 的示例所示:GET/actuator/loggers/{group.name}Spring中文文档

$ curl 'http://localhost:8080/actuator/loggers/test' -i -X GET

前面的示例检索有关名为 的记录器组的信息。 生成的响应类似于以下内容:testSpring中文文档

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 82

{
  "configuredLevel" : "INFO",
  "members" : [ "test.member1", "test.member2" ]
}

响应结构

响应包含所请求组的详细信息。 下表描述了响应的结构:Spring中文文档

路径 类型 描述

configuredLevelSpring中文文档

StringSpring中文文档

记录器组的配置级别(如果有)。Spring中文文档

membersSpring中文文档

ArraySpring中文文档

属于此组的记录器Spring中文文档

路径 类型 描述

configuredLevelSpring中文文档

StringSpring中文文档

记录器组的配置级别(如果有)。Spring中文文档

membersSpring中文文档

ArraySpring中文文档

属于此组的记录器Spring中文文档

设置日志级别

若要设置记录器的级别,请使用指定记录器配置级别的 JSON 正文发出请求,如以下基于 curl 的示例所示:POST/actuator/loggers/{logger.name}Spring中文文档

$ curl 'http://localhost:8080/actuator/loggers/com.example' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{"configuredLevel":"debug"}'

前面的示例将记录器的 设置为 。configuredLevelcom.exampleDEBUGSpring中文文档

请求结构

该请求指定记录器的所需级别。 下表描述了请求的结构:Spring中文文档

路径 类型 描述

configuredLevelSpring中文文档

StringSpring中文文档

记录器的水平。可以省略以清除级别。Spring中文文档

路径 类型 描述

configuredLevelSpring中文文档

StringSpring中文文档

记录器的水平。可以省略以清除级别。Spring中文文档

设置组的日志级别

若要设置记录器的级别,请使用指定记录器组的配置级别的 JSON 正文发出请求,如以下基于 curl 的示例所示:POST/actuator/loggers/{group.name}Spring中文文档

$ curl 'http://localhost:8080/actuator/loggers/test' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{"configuredLevel":"debug"}'

前面的示例将记录器组的 设置为 。configuredLeveltestDEBUGSpring中文文档

请求结构

该请求指定记录器组的所需级别。 下表描述了请求的结构:Spring中文文档

路径 类型 描述

configuredLevelSpring中文文档

StringSpring中文文档

记录器的水平。可以省略以清除级别。Spring中文文档

路径 类型 描述

configuredLevelSpring中文文档

StringSpring中文文档

记录器的水平。可以省略以清除级别。Spring中文文档

清除日志级别

要清除记录器的级别,请使用包含空对象的 JSON 正文发出请求,如以下基于 curl 的示例所示:POST/actuator/loggers/{logger.name}Spring中文文档

$ curl 'http://localhost:8080/actuator/loggers/com.example' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{}'

前面的示例清除记录器的配置级别。com.exampleSpring中文文档