Document D1 errors and expected error rates #18485
Description
Proposed changes
As per the D1 team and what folks have observed since the product hit GA, errors are "not unexpected".
Errors like:
- D1 DB storage operation exceeded timeout which caused object to be reset
- D1_ERROR: Network connection lost
- Internal error while starting up D1 DB storage caused object to be reset
- D1 DB's isolate exceeded its memory limit and was reset
occur somewhat regularly, and you'll find regular reports in the #d1-database channel in Discord.
The team has said:
retry their query and unless there is an underlying issue with the database, it should eventually work
as well as that a handful of errors every several hours is not unexpected.
An example of the number of errors one can expect with D1 over ~9 months:
While these errors occurring might be expected, I don't think this is well documented currently, and should be made clearer that people should develop with these in mind, focusing on building idempotency into their apps if they scale with D1.
Subject Matter
D1
Content Location
https://developers.cloudflare.com/d1/
Additional information
No response