14.2.7 The Loggers Endpoint

The loggers endpoint returns information about the available loggers in the application and permits configuring the their log level.

To get a collection of all loggers by name with their configured and effective log levels, send a GET request to /loggers. This will also provide a list of the available log levels.

$ curl http://localhost:8080/loggers
{
    "levels": [
        "ALL", "TRACE", "DEBUG", "INFO", "WARN", "ERROR", "OFF", "NOT_SPECIFIED"
    ],
    "loggers": {
        "ROOT": {
            "configuredLevel": "INFO",
            "effectiveLevel": "INFO"
        },
        "io": {
            "configuredLevel": "NOT_SPECIFIED",
            "effectiveLevel": "INFO"
        },
        "io.micronaut": {
            "configuredLevel": "NOT_SPECIFIED",
            "effectiveLevel": "INFO"
        },
        // etc...
    }
}

To get the log levels of a particular logger, include the logger name in your GET request. For example, to access the log levels of the logger ‘io.micronaut.http’:

$ curl http://localhost:8080/loggers/io.micronaut.http
{
    "configuredLevel": "NOT_SPECIFIED",
    "effectiveLevel": "INFO"
}

If the named logger does not exist, it will be created with an unspecified (i.e. NOT_SPECIFIED) configured log level. (It’s effective log level will usually be that of the root logger.)

To update the log level of a single logger, send a POST request to the named logger URL and include a body providing the log level to configure.

$ curl -i -X POST
       -H "Content-Type: application/json" \
       -d '{ "configuredLevel": "ERROR" }' \
       http://localhost:8080/loggers/ROOT
HTTP/1.1 200 OK
$ curl http://localhost:8080/loggers/ROOT
{
    "configuredLevel": "ERROR",
    "effectiveLevel": "ERROR"
}