Diagnostics and Support Bundle
Humidity Intelligence is built to explain itself through Home Assistant entities, reason text, generated dashboard state, and diagnostics. When something is confusing, the diagnostics bundle gives maintainers the fastest clean view of what Home Assistant and Humidity Intelligence can actually see.
In Home Assistant:
- Open Settings.
- Open Devices & services.
- Open Humidity Intelligence.
- Use the entry menu.
- Select Download diagnostics.
- Attach the downloaded file to your GitHub issue if you are comfortable sharing it.
Review the file before uploading. The diagnostics path is designed for support, but you remain in control of what you share publicly.
The diagnostics bundle helps answer practical questions quickly:
- which Humidity Intelligence version is installed
- which Home Assistant version is running
- which feature areas are configured
- which telemetry, gate, zone, humidifier, air-quality, alert, and output entities are selected
- whether configured entities are unavailable or unknown
- what runtime mode/lane is currently active
- what the reason text says
- what the current gate states are
- whether generated card data is present
- whether optional frontend dependency information is available
- whether diagnostics warnings are already pointing at the issue
That is usually better than asking for screenshots one at a time.
Diagnostics are intended to be safer than a raw local export, but they are still your Home Assistant data. Review the file before attaching it to a public issue.
The diagnostics flow is expected to redact sensitive values such as:
- tokens and bearer credentials
- secrets and passwords
- API keys
- webhook URLs
- URLs with query credentials
- location-like fields
- usernames, email, phone, host, IP, MAC, SSID, device ID, and unique ID fields
Entity IDs may still be included because they are often needed to debug mappings and unavailable entities. If your entity names contain private information, sanitize them before posting publicly or say that you need a private-safe path.
Use native Home Assistant diagnostics for public GitHub support unless a maintainer asks for something else.
The humidity_intelligence.dump_diagnostics service is a deeper local maintainer/debug
export. It can contain more local context than the native Home Assistant diagnostics
download, so review it carefully before sharing it publicly.
For service examples, see Services Reference.
Open the issue anyway and include:
- Humidity Intelligence version
- Home Assistant version
- install path
- affected area
- what happened
- what you already tried
- sanitized logs or screenshots if helpful
Diagnostics help. A clear issue report is still useful while diagnostics are being sorted out.
| Previous | Next |
|---|---|
| Getting Help | Generated Dashboards |