Unlock the Power of Runtime Log Level Control

Remove the need for restarts or resetting the in-memory state

As a backend developer, logging is essential to monitoring and debugging applications. Traditionally, changing an application’s log level required restarting it or modifying the configuration and redeploying it.

However, there are scenarios where changing the log level at runtime becomes necessary to monitor and troubleshoot applications efficiently. This article introduces the new fastify-log-controller plugin that enables changing the log level of your application at runtime without the need for restarts or resetting the in-memory state!

The wrong log level

Fastify is awesome, and it provides a lot of logging features out of the box:

• One log level for the entire application
• One log level for each encapsulated context
• One log level for each route

This means that you can write this code to customize the log level of your application:

This feature is useful when you want to reduce the noise of the logs or increase the verbosity of a specific context or route. Although this feature is powerful, changing it at runtime by default is impossible.

So, if you don’t implement a custom solution, you can’t adapt to changing debugging or monitoring requirements without restarting the application! And in the worst case, you may need to redeploy the application if the log level is defined in the configuration file!

Sometimes, you may need to increase the log level to get more detailed logs for specific contexts or decrease it to reduce the noise. Having the ability to modify the log level dynamically can significantly enhance your application’s debugging and monitoring capabilities, helping your support team troubleshoot issues faster 🚀!

How to change the log level at runtime

The fastify-log-controller plugin provides a simple and elegant solution to the problem of changing log levels at runtime.

By registering this plugin in your Fastify application, it automatically adds a new route at POST /log-level (configurable) that allows you to control the log levels for different encapsulated contexts!

To use this plugin, you need to follow these steps:

1. Install the plugin and register it in your Fastify application
2. Assign a unique name to each encapsulated context or route
3. Call the POST /log-level route to change the log level of a specific unique name

Here is the first step:

Create a new file, example.js, and add the following scaffold:

Now let’s see how to change the log level of a specific encapsulated context.

Customize the log level of an encapsulated context

To customize the log level of an encapsulated context, you need to assign a unique name to it. So, modify the example.js file as follows:

Now, if you run the application with node example.js, you shouldn’t see any log message in the console. Even if you call the / route, the log level is set to error, and the info message is not logged.

To change the log level of the bar encapsulated context, you need to call the POST /log-level route with the following payload:

Now, if you call the / route, you should see the info message in the console! Since the log level of the bar encapsulated context is set to debug, the info message is logged.

ℹ️ Note

Changing the log level of an encapsulated context will change the log level of all the routes registered in it!

Customize the log level of a route

To customize the log level of a route, you need to do the same thing as for the encapsulated context. In this case, you will need to wrap the route with the register method and set the logCtrl option as before.

So, modify the example.js file as follows:

Now, if you run the application with node example.js, you shouldn’t see any log message in the console. Even if you call the /route URL, the log level is set to error, and the info message is not logged.

To change the log level of the /route route, you need to call the POST /log-level route with the following payload:

Now, if you call the /route route, you should see the info message in the console and the bar encapsulated context is untouched!

ℹ️ Note

If you want more features, like changing the log level of the entire application, you can open a feature request!

Plugin options

The fastify-log-controller plugin accepts the following options:

• optionKey: string (default: logCtrl). The property name used to set the log level of an encapsulated context or route.
• routeConfig: object (default: {}). The object can contain the Fastify route configuration. The configuration of the POST /log-level route. You can’t change only the handler and schema properties, so you will be able to add an authentication strategy.

Summary

In this article, you have found a convenient solution to the problem of changing log levels at runtime in a Fastify application. By registering this plugin, you can dynamically control the log levels for different encapsulated contexts without needing application restarts or resetting the in-memory state.

This plugin introduces a new route at /log-level, allowing you to send a POST request to modify the log level for a specific encapsulated context. With the ability to adjust log levels at runtime, you can fine-tune your logging strategy, enabling more detailed logs for debugging or reducing noise in production environments.

If you want to go deeper into the encapsulated context concept, check out these sources:

• YouTube Video
• Complete Guide to Fastify plugin system
• What is the exact use of fastify-plugin

If you enjoyed this article, comment, share and follow me on Twitter!