cloudflare / cloudflare/cloudflare-docs

Workers Analytics Engine docs should mention the separate account-level prerequisite behind error 10089

Open
#29,844 1 comment 1 reaction 4 assignees Claimed by @WalshyDev View on GitHub
content:edit documentation product:analytics stale
Dominant language
MDX
Stars
5.2k
Forks
16.7k
Avg merge
2d 6h
Merged PRs (30d)
337

Description

### Existing documentation URL(s)

- https://developers.cloudflare.com/analytics/analytics-engine/get-started/

### What changes are you suggesting?

Please add a short note that automatic dataset creation is separate from account-level access to Workers Analytics Engine.

Right now the page says datasets are created automatically, but it does not clearly say that some accounts may still need Analytics Engine enabled or accessible first.

Suggested note:

> Datasets are created automatically after you define a binding and write data. However, some accounts may still need Workers Analytics Engine enabled or accessible at the account level first. Otherwise deploys may fail with `workers.api.error.no_access_to_analytics_engine [code: 10089]`.

**This would help users understand that:**

- dataset creation is automatic
- account access is a separate prerequisite

That distinction would make the setup docs clearer and help users diagnose error `10089` faster.

### Additional information

This seems related to closed issue [#21972](https://github.com/cloudflare/cloudflare-docs/issues/21972), but while the sidebar was changed, the current page still appears to miss this clarification in writing.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.