diff --git a/source/_integrations/zha.markdown b/source/_integrations/zha.markdown index 7aacddb1096..010f96e35b1 100644 --- a/source/_integrations/zha.markdown +++ b/source/_integrations/zha.markdown @@ -157,6 +157,36 @@ Reset your Zigbee devices according to the device instructions provided by the m ## Troubleshooting +### Reporting issues + +When reporting issues, please provide the following information in addition to information requested by issue template: + +1. Debug logs for the issue, see [debug logging](#debug-logging) +2. Model of Zigbee radio being used +3. If issue is related to a specific Zigbee device, provide device Zigbee signature. Signature is available at +`Configuration` Panel -> `Zigbee Home Automation` -> Pick your Device -> `Zigbee Information` + +### Debug logging + +To enable debug logging for ZHA component ard radio libraries, add the following [logger](https://www.home-assistant.io/integrations/logger/) configuration to `configuration.yaml`: + +```yaml +logger: + default: info + logs: + homeassistant.core: debug + homeassistant.components.zha: debug + bellows.zigbee.application: debug + bellows.ezsp: debug + zigpy: debug + zigpy_cc: debug + zigpy_deconz.zigbee.application: debug + zigpy_deconz.api: debug + zigpy_xbee.zigbee.application: debug + zigpy_xbee.api: debug + zigpy_zigate: debug +``` + ### Add Philips Hue bulbs that have previously been added to another bridge Philips Hue bulbs that have previously been added to another bridge won't show up during search. You have to restore your bulbs back to factory settings first. To achieve this, you basically have the following options.