System Logs
System Logs, released in Directus 11.1.0, shows the Directus application logs in real-time. This is useful for debugging and monitoring the Directus application as it runs.
Logs are shown in the System Logs pane in realtime as the Directus application receives queries originating from the Data Studio or API.
Each log message contains the following information:
level- The log level of the message.time- The timestamp of the log message.msg- The message of the log containing the method and path.
Ephemeral Logs
System Logs are ephemeral and not stored in the database. They are only available while the realtime connection is active. Refreshing the page will clear the logs.
Enabling System Logs
System Logs rely on WebSockets for real-time connectivity. To enable this feature:
- Ensure the
WEBSOCKETS_ENABLEDenvironment variable is set totrue. - Verify that the
WEBSOCKETS_LOGS_ENABLEDenvironment variable is set totrue(it defaults totrueif not explicitly configured).
Log Levels
Under the hood, Directus uses pino for logging and uses the log levels provided by the library:
| Log Level | Numeric Value |
|---|---|
trace | 10 |
debug | 20 |
info | 30 |
warn | 40 |
error | 50 |
fatal | 60 |
You can enable different log levels shown in System Logs via the WEBSOCKETS_LOGS_LEVEL environment variable.
Searching & Filtering
If running multiple instances of Directus in a horizontally-scaled setup, you can also filter the logs by instance in the System Logs pane.
You can also filter the logs by level, or filter by search terms in the msg field.