Debug Logging

Enabling debug logging helps troubleshoot issues with the Android Management API integration.

Enable debug logs

Add the following to your Home Assistant configuration.yaml:

logger:
  logs:
    custom_components.android_management_api: debug

Then:

Save the file.
Restart Home Assistant (or reload the Logger integration under Settings → System → Control if you use the UI).
Reproduce the issue (e.g. add the integration, press a button, refresh the enrollment QR code).
Check the logs.

Settings → System → Logs in the Home Assistant UI.
Or the log file on the host (e.g. /config/home-assistant.log or the path used by your installation).

With custom_components.android_management_api set to debug, the integration will log:

API requests and responses (including errors)
Config and options flow steps
Coordinator updates and device list changes
Service calls (e.g. set_policy, set_kiosk_policy, create_enrollment_token, device-level services like clear_app_data, start_lost_mode, patch_device, etc.)
Authentication and validation steps

Use this to verify credentials, policy IDs, enterprise names, and any error messages returned by the Android Management API.

To reduce log volume after troubleshooting:

Remove the custom_components.android_management_api: debug line from configuration.yaml, or change debug to info or warning.
Restart Home Assistant or reload the Logger integration.