mention the hierarchical namespace for logging #2786
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
5 tasks
Nerivec
reviewed
Jun 3, 2024
docs/guide/configuration/logging.md
Outdated
| ``` | ||
|
|
||
| ## Defining levels for specific namespace hierarchy | ||
| The log levels defined in `log_namespaced_levels` will apply to the namespace itself and all namespaces below unless explicitely configured. | ||
| In addition to the regex based debug filter [#preventing-specific-namespaces-from-being-logged] it allows to fine tune your logging needs to great detail. |
There was a problem hiding this comment.
The log levels defined in
log_namespaced_levelswill apply to the namespace itself and all namespaces below unless explicitely configured.
In addition to the regex based debug filter [#preventing-specific-namespaces-from-being-logged] it allows to fine tune your logging needs to great detail.
=>
Any log level defined in log_namespaced_levels will apply to the namespace itself and all namespaces below it, unless explicitly configured.
Regex part is described below and only applies to debug, so I don't think we need to mention it here.
Nerivec
reviewed
Jun 3, 2024
docs/guide/configuration/logging.md
Outdated
| log_level: warning | ||
| log_namespaced_levels: | ||
| 'zhc': info | ||
| 'zhc:legacy:fz' : debug |
There was a problem hiding this comment.
advanced:
log_level: warning
log_namespaced_levels:
zhc: info
zhc:legacy:fz: debug(same at the top, can remove the quotes wrapping namespace)
Nerivec
reviewed
Jun 3, 2024
docs/guide/configuration/logging.md
Outdated
|
|
||
| - All namespaces bellow `zhc` will be logged as info | ||
| - Except all namespaces bellow `zhc:legacy:fz` that will be logged as debug | ||
| - All the rest uses the `warning` level` |
There was a problem hiding this comment.
- All namespaces bellow `zhc` will be logged as info
- Except all namespaces bellow `zhc:legacy:fz` that will be logged as debug
- All the rest uses the `warning` level`=>
- `zhc` and below namespaces will be logged as `info` (examples: `zhc`, `zhc:ota:common`, `zhc:legacy:tz`)
- `zhc:legacy:fz` and below namespaces will be logged as `debug` (examples: `zhc:legacy:fz`, `zhc:legacy:fz:tuya`)
- Other unspecified namespaces will use `log_level`, in this case, `warning` (examples: `z2m:mqtt`, `zh:zstack`)
|
Thanks! |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Documents hierarchical namespace log levels
Koenkk/zigbee2mqtt#22859