Home Assistant

Logger

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 have a full log and log everything only this entry is needed (without any qualifier):

logger:

To log all messages and ignore events lower than critical for specified components.

# Example configuration.yaml entry
logger:
  default: info
  logs:
    homeassistant.components.device_tracker: critical
    homeassistant.components.camera: critical

To ignore all messages lower than critical and log event for specified components.

# Example configuration.yaml entry
logger:
  default: critical
  logs:
    homeassistant.components: info
    homeassistant.components.rfxtrx: debug
    homeassistant.components.device_tracker: critical
    homeassistant.components.camera: critical

Possible log severities are:

  • critical
  • fatal
  • error
  • warning
  • warn
  • info
  • debug
  • notset

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.

An example call might look like this:

service: logger.set_level
data:
  homeassistant.components: warning
  homeassistant.components.media_player.yamaha: debug

The log information are stored in the configuration directory 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:

$ 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:

$ tail -f /config/home-assistant.log