Read ESPHome device logs
esphome_logsRead-only
Stream live logs from an ESPHome device to inspect boot messages, Wi-Fi/API issues, sensor readings, crashes, and reboot reasons after flashing or when it misbehaves.
Instructions
Stream the live logs from an ESPHome device and return what was captured. This is the way to see what a device is actually doing — boot messages, wifi/API connection problems, sensor readings, crashes and reboot reasons. Use it after flashing, or whenever a device is behaving oddly. Returns once the timeout elapses, so set timeout_seconds to how long you want to watch. Runs over the VomeHome relay — no ports to open. If a call reports that ESPHome is unreachable, run esphome_dashboard_info to see why rather than telling the user this is unsupported.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| port | No | Device address (IP/hostname) or 'OTA' for logs over the network. Defaults to 'OTA'. | |
| full_output | No | Return every line of output. By default a long output comes back summarised: all errors and warnings, memory use, and the last lines. | |
| instance_id | No | Optional: the instance you mean (as listed by vomehome_list_instances). When given, the call is refused if this session is targeting a different home, instead of answering from it. | |
| configuration | Yes | Configuration filename, e.g. 'living-room.yaml'. | |
| timeout_seconds | No | How long to capture logs for. Defaults to the standard command timeout. |