[[loggers]]
= Loggers (`loggers`)

The `loggers` endpoint provides access to the application's loggers and the configuration
of their levels.



[[loggers-all]]
== Retrieving All Loggers

To retrieve the application's loggers, make a `GET` request to `/actuator/loggers`, as
shown in the following curl-based example:

include::{snippets}loggers/all/curl-request.adoc[]

The resulting response is similar to the following:

include::{snippets}loggers/all/http-response.adoc[]



[[loggers-all-response-structure]]
=== Response Structure

The response contains details of the application's loggers. The following table describes
the structure of the response:

[cols="3,1,3"]
include::{snippets}loggers/all/response-fields.adoc[]



[[loggers-single]]
== Retrieving a Single Logger

To retrieve a single logger, make a `GET` request to `/actuator/loggers/{logger.name}`,
as shown in the following curl-based example:

include::{snippets}loggers/single/curl-request.adoc[]

The preceding example retrieves information about the logger named `com.example`. The
resulting response is similar to the following:

include::{snippets}loggers/single/http-response.adoc[]



[[loggers-single-response-structure]]
=== Response Structure

The response contains details of the requested logger. The following table describes the
structure of the response:

[cols="3,1,3"]
include::{snippets}loggers/single/response-fields.adoc[]



[[loggers-setting-level]]
== Setting a Log Level

To set the level of a logger, make a `POST` request to
`/actuator/loggers/{logger.name}` with a JSON body that specifies the configured level
for the logger, as shown in the following curl-based example:

include::{snippets}loggers/set/curl-request.adoc[]

The preceding example sets the `configuredLevel` of the `com.example` logger to `DEBUG`.



[[loggers-setting-level-request-structure]]
=== Request Structure

The request specifies the desired level of the logger. The following table describes the
structure of the request:

[cols="3,1,3"]
include::{snippets}loggers/set/request-fields.adoc[]



[[loggers-clearing-level]]
== Clearing a Log Level

To clear the level of a logger, make a `POST` request to
`/actuator/loggers/{logger.name}` with a JSON body containing an empty object, as shown
in the following curl-based example:

include::{snippets}loggers/clear/curl-request.adoc[]

The preceding example clears the configured level of the `com.example` logger.
