Skip to content

Improve readability of Log Levels #5735

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
swoboda1337 merged 5 commits into from
Dec 7, 2025
Merged

Improve readability of Log Levels #5735

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
ae60b93
Improved readability of Log Levels
Undearius Dec 6, 2025
781a1b1
Removed HTML line break
Undearius Dec 6, 2025
9ce8569
Added table header
Undearius Dec 6, 2025
7e09a1c
Cleanup
swoboda1337 Dec 7, 2025
70eb0f0
Cleanup
swoboda1337 Dec 7, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 12 additions & 36 deletions content/components/logger.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -126,42 +126,18 @@ the original ESP32 or ESP8266) continue to use USB-to-serial bridge ICs for comm

Possible log levels are (sorted by severity):

- `NONE`

- No messages are logged.

- `ERROR`

- With this log level, only errors are logged. Errors are issues that prevent the ESP from working

correctly. Color: red

- `WARN`

- With this log level, warnings and errors are logged. Warnings are issues like invalid readings from

sensors that ESPHome can recover from. Color: yellow

- `INFO`

- With this log level, everything up to info messages are logged; so errors, warnings and info. Color: green

- `DEBUG` (**Default**)

- Everything up to this log level is logged. Debug messages include the current readings from a sensor

and status messages. Color: cyan

- `VERBOSE`

- Like debug, but a few more messages that are usually deemed to be spam are also included. Color: grey

- `VERY_VERBOSE`

- All internal messages are logged. Including all the data flowing through data buses like

I²C, SPI or UART. Warning: May cause the device to slow down and have trouble staying
connecting due to amount of generated messages. Color: white
| Level | Color | Description |
| ------------------ | ------ | ----------- |
| `NONE` | | No messages are logged. |
| `ERROR` | Red | Only errors are logged. Errors prevent the ESP from working correctly. |
| `WARN` | Yellow | Warnings and errors. Warnings are recoverable issues like invalid sensor readings. |
| `INFO` | Green | Errors, warnings and info messages are logged. |
| `DEBUG` (default) | Cyan | Everything up to debug. Includes sensor readings and status messages. |
| `VERBOSE` | Gray | Like debug, but includes additional messages usually deemed to be spam. |
| `VERY_VERBOSE` | White | All internal messages including data flowing through I²C, SPI and UART buses. |

> [!WARNING]
> Using `VERY_VERBOSE` can significantly impact device performance and may cause connection instability.

{{< anchor "logger-manual_tag_specific_levels" >}}

Expand Down