Repository navigation
Upgrade
Upgrading means installing the new package version and redeploying. Table changes run by themselves. Settings, Search connections, salts and stored collections (sites, keys, goals, dashboards, shares, annotations, rules) carry over.
-
Read the release notes of the version on GitHub. The semver surface is route names, the ingest JSON, the window API, settings keys, table and column names, the agent API and the exports of
./contractand./server. -
Back up each analytics database and note the Time Travel bookmark:
npx wrangler d1 export site --remote --output=before-upgrade.sql npx wrangler d1 time-travel info siteOn the Free plan, take the export early in the UTC day.
-
Update the package, commit the lockfile and redeploy:
npm install @infinitnet/cookieless-analytics@latest
-
If you run the Queue-Worker, set the consumer's
@infinitnet/cookieless-analyticsversion to the same version and deploy it too:npx wrangler deploy
-
Open the admin. The footer shows the installed version.
-
Check: load one page of the site in a private window, then open the Data page. No
write_errorcount appears under "Not recorded", and Overview shows the visit.
Migrations are forward only: the stored schema version never moves back. They run when the plugin activates and again, lazily, before the first write, in every server instance and in every own analytics database. Nothing has to be run by hand. A release that changes the tables says so in its release notes.
The repository has a storage check that posts one synthetic page view and reads it back through the agent API. It needs a key with the read:analytics scope:
CA_API_KEY=abcd1234.your-secret node scripts/smoke-storage.mjs --base https://example.comIt costs about 3 rows written and leaves one visit to a /ca-smoke-<random> path in the reports.
No setting needs to change for an upgrade. On Workers Free, check that capacityProfile is small.
- Peer range:
emdash>=1.4.0 <2. CI checks 1.4.0 and the latest 1.x release. Stay on that range.
- The queue consumer must run the same plugin version as the site. Messages carry the plugin's own format.
- A Time Travel restore resets the whole database, CMS content included.
- A restore or import writes rows; on the Free plan run it early in the UTC day.
- Upgrading the package does not change your settings. New settings start at their defaults; see Settings-Reference.
Quick-Install, Queue-Worker, Capacity-Profiles-and-Cloudflare-Plans, Data-Page, Troubleshooting.
Full reference: https://github.com/infinitnet/cookieless-analytics/blob/main/docs/install.md
Cookieless Analytics by Infinitnet, Apache-2.0. These pages are generated from docs/wiki in the repository; edit them there, not here.
Start
Reports
- Reports
- Filters and segments
- Search Satisfaction
- Goals and funnels
- Revenue and refunds
- Links report
- Search integrations
- Content and site search
Sending data
Sharing and context
Sites
Admin
Running it