The Quarkus Logging Manager Extension provides you endpoints to visualize and manage the log level of your loggers.
Endpoint | Http Method | Description |
---|---|---|
/logging-manager |
GET |
Returns the list of all loggers, with information about the configured and effective level |
/logging-manager?loggerName={loggerName} |
GET |
Returns the logger specified by this name, with information about the configured and effective level |
/logging-manager |
POST |
Changes the log level of the specified logger |
/logging-manager/levels |
GET |
Get all the available level |
Security of endpoints is important and we do not want to allow unknown people to know (or worse, change!) the log levels of our applications. Fortunately we can secure our endpoints using Quarkus' default security mechanism, as described in here. All you have to do is define your application.properties similar to this:
quarkus.http.auth.basic=true # If you want basic auth. Multiple auth mechanism are supported
quarkus.http.auth.policy.admin-access.roles-allowed=admin
quarkus.http.auth.permission.roles1.paths=/loggers
quarkus.http.auth.permission.roles1.policy=admin-access
And, in case you chose Basic Auth, provide a IdentityProvider (either by implementing one or adding an extension that provides
one).
Quarkus will take care of matching the paths (in this case /loggers
to the policy you defined and granting or denying access).
Then you can also secure all the endpoints in your application using this configuration.
To use this in your application, simply add this in your pom.xml:
<dependency>
<groupId>io.quarkiverse.loggingmanager</groupId>
<artifactId>quarkus-logging-manager</artifactId>
<version>${logger-manager.version}</version>
<scope>runtime</scope>
</dependency>
Note: Replace ${logger-manager.version}
with the latest version
You can include the Logger Manager API in the OpenAPI document (and thus also Swagger UI). This needs to be enabled via config:
quarkus.logging-manager.openapi.included=true
This will then add the following to your OpenAPI:
- OpenApiSpec for the endpoints
- Make endpoint configurable
- Enable customizable security on the endpoint (see readme file)
Thanks goes to these wonderful people (emoji key):
oscarfh 💻 🚧 |
Phillip Krüger 💻 🚧 |
This project follows the all-contributors specification. Contributions of any kind welcome!