How to Capture a ZHA Advanced Debug Log in Home Assistant

How to Capture a ZHA Advanced Debug Log in Home Assistant

Step 1: Turn On Debug Logging

  1. Open Home Assistant in your web browser.

  2. Go to Settings → Integrations.

  3. Find Zigbee Home Automation (ZHA) and click on it.

  4. Click the three dots menu in the top-right corner.

  5. Select Enable Debug Logging.

This temporarily records detailed information about your Zigbee network, including pairing attempts.

Step 2: Attempt to Pair Your Device

  1. Put your Zigbee device into pairing mode.

  2. Try pairing it in Home Assistant as you normally would.

  3. Allow a few minutes for the device to communicate so sufficient log data is collected.

Step 3: Download the Log

  1. Return to the same three dots menu in the ZHA integration page.

  2. Disable debug logging.

  3. Home Assistant will automatically create a debug log file.

  4. Download the file and send it to us for review.

This log contains all the steps Home Assistant took while pairing your device, which helps identify the issue quickly.

    • Related Articles

    • [C201] Firmware update instructions for ZHA

      Please note these instructions are currently for ZHA only. If your date code is 20241020, 20240813 or 20230824 and you're using ZHA you do not need to do this update. You should not attempt this update unless your batch # and date code aren't in the ...

    • [C202 Family] Firmware update instructions for ZHA

      Please note these instructions are currently for ZHA only. You should not attempt this update unless your batch # and date code aren't in the table below. The most up to date firmwares have Date Codes: 20250201. The most up to date sw build id is ...

    • [C-ZB-LC20] Firmware update instructions for Home Assistant (ZHA and zigbee2mqtt)

      After the update, the device should report as C-ZB-LC20v2. zigbee2mqtt The update is available directly within the zigbee2mqtt interface. ZHA 1. Create a new folder inside your Home Assistant “config” directory for storing the OTA firmware file. In ...

    • [CSF1TZ] How do I install Home Assistant ZHA quirks?

      To do this you must have file editor installed on your Home Assistant instance. Editing your configuration.yaml file. On your Home Assistant instance click file editor. Click the folder button ("Browse Filesystem") Select configuration.yaml, and then ...

    • [CMM-1] How do I install a new Home Assistant blueprint?

      Due to the Zigbee2MQTT 2.0.0 update, the Zigbee2MQTT blueprint has been updated, the old blueprint no longer works. (08/01/2025) If you haven't already installed our original blueprint, you can go ahead and click the Zigbee2MQTT Import to my home ...