mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-16 05:46:52 +00:00
Add set_default_level documentation (#5460)
* Add set_default_level documentation
* ✏️ Tweaks
* More logger changes
This commit is contained in:
parent
46a1b6db4e
commit
45adcc81b8
@ -11,15 +11,16 @@ logo: home-assistant.png
|
||||
ha_category: "Utility"
|
||||
---
|
||||
|
||||
The logger component lets you define the level of logging activities in Home Assistant.
|
||||
The `logger` component lets you define the level of logging activities in Home Assistant.
|
||||
|
||||
To enable the logger in your installation, add the following to your `configuration.yaml` file:
|
||||
To enable the `logger` component in your installation, add the following to your `configuration.yaml` file:
|
||||
|
||||
To have a full log and log everything only this entry is needed (without any qualifier):
|
||||
```yaml
|
||||
# Example configuration.yaml entry
|
||||
logger:
|
||||
```
|
||||
To log all messages and ignore events lower than critical for specified components.
|
||||
|
||||
To log all messages and ignore events lower than critical for specified components:
|
||||
|
||||
```yaml
|
||||
# Example configuration.yaml entry
|
||||
@ -30,7 +31,7 @@ logger:
|
||||
homeassistant.components.camera: critical
|
||||
```
|
||||
|
||||
To ignore all messages lower than critical and log event for specified components.
|
||||
To ignore all messages lower than critical and log event for specified components:
|
||||
|
||||
```yaml
|
||||
# Example configuration.yaml entry
|
||||
@ -43,7 +44,25 @@ logger:
|
||||
homeassistant.components.camera: critical
|
||||
```
|
||||
|
||||
Possible log severities are:
|
||||
{% configuration %}
|
||||
default:
|
||||
description: Default log level.
|
||||
required: false
|
||||
type: '[log_level](#log-levels)'
|
||||
default: debug
|
||||
logs:
|
||||
description: List of components and their log level.
|
||||
required: false
|
||||
type: map
|
||||
keys:
|
||||
'<component_namespace>':
|
||||
description: Logger namespace of the component.
|
||||
type: '[log_level](#log-levels)'
|
||||
{% endconfiguration %}
|
||||
|
||||
### {% linkable_title Log Levels %}
|
||||
|
||||
Possible log severity levels are:
|
||||
|
||||
- critical
|
||||
- fatal
|
||||
@ -54,10 +73,25 @@ Possible log severities are:
|
||||
- debug
|
||||
- notset
|
||||
|
||||
## {% linkable_title Services %}
|
||||
|
||||
### {% linkable_title Service `set_default_level` %}
|
||||
|
||||
You can alter the default log level (for components without a specified log
|
||||
level) using the service `logger.set_default_level`.
|
||||
|
||||
An example call might look like this:
|
||||
|
||||
```yaml
|
||||
service: logger.set_default_level
|
||||
data:
|
||||
level: info
|
||||
```
|
||||
|
||||
### {% linkable_title Service `set_level` %}
|
||||
|
||||
You can alter log level for one or several components using the service
|
||||
``logger.set_level``. It accepts the same format as ``logs`` in the configuration.
|
||||
`logger.set_level`. It accepts the same format as `logs` in the configuration.
|
||||
|
||||
An example call might look like this:
|
||||
|
||||
@ -68,7 +102,9 @@ data:
|
||||
homeassistant.components.media_player.yamaha: debug
|
||||
```
|
||||
|
||||
The log information are stored in the [configuration directory](/docs/configuration/) as `home-assistant.log` and you can read it with the command-line tool `cat` or follow it dynamically with `tail -f`.
|
||||
The log information are stored in the [configuration directory](/docs/configuration/)
|
||||
as `home-assistant.log` and you can read it with the command-line tool `cat` or
|
||||
follow it dynamically with `tail -f`.
|
||||
|
||||
If you are a Hassbian user you can use the example below:
|
||||
|
||||
@ -76,7 +112,8 @@ If you are a Hassbian user you can use the example below:
|
||||
$ tail -f /home/homeassistant/.homeassistant/home-assistant.log
|
||||
```
|
||||
|
||||
If you are a Hass.io user you can use the example below, whenlogged in through the ssh addon:
|
||||
If you are a Hass.io user, you can use the example below, when logged in through
|
||||
the [SSH add-on](/addons/ssh/):
|
||||
|
||||
```bash
|
||||
$ tail -f /config/home-assistant.log
|
||||
|
Loading…
x
Reference in New Issue
Block a user