{"record":{"id":"54a9a16bb0f45301","repo":"home-assistant/core","slug":"timeout-during-backup-operation-in-func-name","errorCode":null,"errorMessage":"Timeout during backup operation in {func.__name__}","messagePattern":"Timeout during backup operation in (.+?)","errorType":"exception","errorClass":"BackupAgentError","httpStatus":null,"severity":"error","filePath":"homeassistant/components/azure_storage/backup.py","lineNumber":85,"sourceCode":"    ) -> _R:\n        try:\n            return await func(self, *args, **kwargs)\n        except HttpResponseError as err:\n            _LOGGER.debug(\n                \"Error during backup in %s: Status %s, message %s\",\n                func.__name__,\n                err.status_code,\n                err.message,\n                exc_info=True,\n            )\n            # pylint: disable-next=home-assistant-exception-not-translated\n            raise BackupAgentError(\n                f\"Error during backup operation in {func.__name__}:\"\n                f\" Status {err.status_code}, message: {err.message}\"\n            ) from err\n        except ServiceRequestError as err:\n            # pylint: disable-next=home-assistant-exception-not-translated\n            raise BackupAgentError(\n                f\"Timeout during backup operation in {func.__name__}\"\n            ) from err\n        except AzureError as err:\n            _LOGGER.debug(\n                \"Error during backup in %s: %s\",\n                func.__name__,\n                err,\n                exc_info=True,\n            )\n            # pylint: disable-next=home-assistant-exception-not-translated\n            raise BackupAgentError(\n                f\"Error during backup operation in {func.__name__}: {err}\"\n            ) from err\n\n    return wrapper\n\n\nclass AzureStorageBackupAgent(BackupAgent):","sourceCodeStart":67,"sourceCodeEnd":103,"githubUrl":"https://github.com/home-assistant/core/blob/58a3fdb3ea0538617f0a07efcfba6294de64fd59/homeassistant/components/azure_storage/backup.py#L67-L103","documentation":"BackupAgentError raised by handle_backup_errors when an azure.core.exceptions.ServiceRequestError occurs during an Azure Storage backup operation. ServiceRequestError indicates the request was never successfully delivered (connection error, DNS failure, client-side timeout), so it is reported distinctly as a 'Timeout during backup operation'.","triggerScenarios":"Network-level failure while calling blob APIs: connection reset, DNS resolution failure for <account>.blob.core.windows.net, or the request timing out client-side during upload/download of a large backup.","commonSituations":"HA host loses internet mid-backup, slow uplink causing large backup uploads to time out, restrictive firewall or DNS failure, container running with a small keepalive window.","solutions":["Verify network/DNS from the HA host to the storage endpoint","For recurring upload timeouts, schedule backups when the uplink is idle or split large backups","Retry the backup operation once connectivity is restored; HA's backup manager can retrigger","If behind a proxy, ensure it permits long-lived streaming connections"],"exampleFix":null,"handlingStrategy":"retry","validationCode":"import socket\nsocket.gethostbyname(f\"{account_name}.blob.core.windows.net\")  # DNS pre-check before long backup","typeGuard":"def is_request_error(err: BaseException) -> bool:\n    from azure.core.exceptions import ServiceRequestError\n    return isinstance(err, ServiceRequestError)","tryCatchPattern":"except ServiceRequestError as err:\n    raise BackupAgentError(f\"Timeout during backup operation in {func.__name__}\") from err","preventionTips":["Verify DNS/egress to blob endpoints before scheduling large backups","Retry the backup operation after connectivity is restored","Avoid backing up over flaky links; the operation aborts wholesale on transport failure"],"tags":["azure","blob-storage","backup","timeout","network"],"backgroundTag":null,"analyzedSha":"58a3fdb3ea0538617f0a07efcfba6294de64fd59","analyzedAt":"2026-08-14T20:54:38.818Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}