Debugging

Home Assistant

If an integration isn't working as it should, you can opt to enable debug logging in Home Assistant. This will show you logs for every step the integration's taking, so you (or the dev) can better determine what's going wrong.

Go to your file-editor-of-choice in HA, and open configuration.yaml. Add the following snippet:

logger:
  default: warning
  logs:
    custom_components.hass_agent: debug

This is for the new integration. If you use either of the old ones, you can add these rows:

    custom_components.hass_agent_notifier: debug
    custom_components.hass_agent_mediaplayer: debug

Reboot HA, and it'll be activated.

Tip: install the Log Viewer add-on for easy viewing.

You should see rows like this coming in:

image

HASS.Agent

If you're sure everything's working from HA's end, you can check HASS.Agent's logs. Open the Configuration window, navigate to the Logging page and click Open Logs Folder:

image

In there, sort by date, and open the latest log. You can ignore the files containing restart or update etc. in their name:

image

Attach the content of the log to a GitHub ticket.

If the log's not showing anything interesting, you can enable Extended Logging:

image

Restart HASS.Agent and try to reproduce your error.

Note: disable this afterwards, as it can make the logfiles grow really large!