> ## Documentation Index
> Fetch the complete documentation index at: https://lightdash-mintlify-9d2ee1df.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure logging for Lightdash

<Note>
  🛠 This page is for engineering teams self-hosting their own Lightdash instance. If you want to monitor usage and analytics, go to the [Usage analytics](/references/workspace/usage-analytics) guide.
</Note>

By default Lightdash logs to the console in a human readable format. You can configure the logging behaviour, such as logging to a file or using a JSON format, by using the following environment variables:

| Variable                       | Description                                                 | Required? |         Default        |
| :----------------------------- | :---------------------------------------------------------- | :-------: | :--------------------: |
| `LIGHTDASH_LOG_LEVEL`          | The minimum level of log messages to display                |           |         `INFO`         |
| `LIGHTDASH_LOG_FORMAT`         | The format of log messages                                  |           |        `pretty`        |
| `LIGHTDASH_LOG_OUTPUTS`        | The outputs to send log messages to                         |           |        `console`       |
| `LIGHTDASH_LOG_CONSOLE_LEVEL`  | The minimum level of log messages to display on the console |           |  `LIGHTDASH_LOG_LEVEL` |
| `LIGHTDASH_LOG_CONSOLE_FORMAT` | The format of log messages on the console                   |           | `LIGHTDASH_LOG_FORMAT` |
| `LIGHTDASH_LOG_FILE_LEVEL`     | The minimum level of log messages to write to the log file  |           |  `LIGHTDASH_LOG_LEVEL` |
| `LIGHTDASH_LOG_FILE_FORMAT`    | The format of log messages in the log file                  |           | `LIGHTDASH_LOG_FORMAT` |
| `LIGHTDASH_LOG_FILE_PATH`      | The path to the log file                                    |           |    `./logs/all.log`    |