Observability, logging and MQTT

[nate]

It’s actually really easy to log remotely via esphome dashboard or command line and I’ve been meaning to write some documentation on this.

ESPHome dashboard (in browser)

If you’re using the ESPHome add-on for Home Assistant (or running ESPHome dashboard separately) you should be able to stream logs directly from there in the browser:

Command line method

1. Install esphome if you don’t have it already. I work on a mac and I use homebrew to easily manage esphome CLI:

   brew install esphome and brew upgrade esphome when new releases are published.

2. Download the base firmware config for your product from konnected-esphome. For the blaQ that’s garage-door-GDOv2-Q.yaml. Click the download button to save the file to your computer or just clone the open-source repo.

3. Find the IP address (or internal hostname) of the blaQ on your network. You can use the Konnected app, your router, ESPhome dasboard, etc to find this.

4. Run esphome logs in a terminal:

   esphome logs garage-door-GDOv2-Q.yaml --device 192.168.86.11
   

   or

   esphome logs garage-door-GDOv2-Q.yaml --device gdo-blaq-abc123.local
   

5. Colorized logs will scroll in the terminal window. Press CTRL-C or ⌘-C to exit.