home-assistant/core · error · UpdateFailed

Error communicating with Homeassistant Analytics

Error message

Error communicating with Homeassistant Analytics

What it means

Raised as UpdateFailed when any of the three per-refresh calls (get_addons, get_current_analytics, get_custom_integrations) fails with HomeassistantAnalyticsConnectionError inside _async_update_data. Functionally identical to the setup-time error (183) but occurring on an established entry; entities keep their last values and the coordinator retries on its schedule.

Source

Thrown at homeassistant/components/analytics_insights/coordinator.py:78

        self._client = client
        self._tracked_apps = self.config_entry.options.get(CONF_TRACKED_APPS, [])
        self._tracked_integrations = self.config_entry.options[
            CONF_TRACKED_INTEGRATIONS
        ]
        self._tracked_custom_integrations = self.config_entry.options[
            CONF_TRACKED_CUSTOM_INTEGRATIONS
        ]

    @override
    async def _async_update_data(self) -> AnalyticsData:
        try:
            apps_data = (
                await self._client.get_addons()
            )  # Still add method name. Needs library update
            data = await self._client.get_current_analytics()
            custom_data = await self._client.get_custom_integrations()
        except HomeassistantAnalyticsConnectionError as err:
            raise UpdateFailed(
                "Error communicating with Homeassistant Analytics"
            ) from err
        except HomeassistantAnalyticsNotModifiedError:
            return self.data
        apps = {app: get_app_value(apps_data, app) for app in self._tracked_apps}
        core_integrations = {
            integration: data.integrations.get(integration, 0)
            for integration in self._tracked_integrations
        }
        custom_integrations = {
            integration: get_custom_integration_value(custom_data, integration)
            for integration in self._tracked_custom_integrations
        }
        return AnalyticsData(
            data.active_installations,
            data.reports_integrations,
            apps,
            core_integrations,

View on GitHub (pinned to 58a3fdb3ea)

Solutions

1. Treat as transient: the coordinator retries automatically; check whether subsequent refreshes succeed.
2. Verify outbound connectivity to analytics.next.home-assistant.io.
3. If persistent, reload the integration to rebuild the client session.
4. Check logs for the underlying HomeassistantAnalyticsConnectionError detail.

In _async_update_data consumers, treat UpdateFailed('Error communicating...') as transient; entities retain prior data by design.

When it happens

Trigger: A coordinator refresh while the network is down, the analytics service is temporarily unavailable, or the client session is dropped (HA restart of the aiohttp session, long-lived entry going stale).

Common situations: Transient internet dropouts, analytics service maintenance windows, or rate limiting after too-frequent updates.

Related errors

• Unable find multi-factor auth module: {mfa_module_id}
• {error}
• Error communicating with API: {err}
• Cannot connect to Ambient Network
• {err}

AI-assisted analysis of home-assistant/core@58a3fdb3ea (2026-08-14). Data as JSON: /api/errors/e828db6fc1457594. Report an issue: GitHub.