|
| 1 | +InsightFlare v0.5.0 moves operational visibility down to the request entry layer, building a more complete loop around bot protection, abnormal request diversion, and request observation. |
| 2 | + |
| 3 | +This release focuses on "bot defense and observation." Sites can identify high-risk bot traffic at the collection entry point, divert it away from the normal analytics path, and use Cloudflare Analytics Engine to inspect bot requests, normal requests, abnormal ratios, source distribution, and recent request details. System administrators can also configure Analytics Engine read credentials in the management area, open the request observation page, and get clearer deployment and configuration feedback when Analytics Engine has not been enabled yet. |
| 4 | + |
| 5 | +> Note: Starting with this update, InsightFlare uses Cloudflare Analytics Engine for additional enhanced analysis. You need to **enable Analytics Engine in the Cloudflare Dashboard first** before InsightFlare can use it. |
| 6 | +> |
| 7 | +> Open https://dash.cloudflare.com/?to=/:account/workers/analytics-engine and click the "Enable" button on the right. After that, InsightFlare will automatically bind Analytics Engine to your Cloudflare account during deployment. |
| 8 | +
|
| 9 | +## Highlights |
| 10 | + |
| 11 | +- Added bot traffic diversion. The collection entry point now combines `isbot`, Cloudflare Bot Score, verified bot categories, ASN classification, and request characteristics to identify bot requests and separate high-confidence bot traffic from the normal analytics path. |
| 12 | +- Added signed collect tokens. The tracking script and collection endpoint now use signed tokens for stronger validation, reducing the risk of third parties forging collection requests directly. |
| 13 | +- Added a request observation page. Administrators can inspect total request volume, bot request ratio, the normal collection path, abnormal request trends, Bot Score buckets, verified bot categories, ASN types, and recent request details. |
| 14 | +- Added Analytics Engine system settings. Administrators can configure the Cloudflare Account ID and API Token used to read the bot and normal request datasets in Analytics Engine. |
| 15 | +- Added normal request Analytics Engine records. In addition to bot requests, normal collection requests are written to a separate dataset, making it easier to compare diverted requests with requests that entered the product analytics path. |
| 16 | +- Improved the bot request detail drawer by preserving geographic coordinates, request context, identification reasons, and trace information, making false positives, crawler sources, and abnormal access patterns easier to investigate. |
| 17 | +- Improved the Analytics Engine deployment experience. When Analytics Engine is not enabled on a Cloudflare account, the publish flow can fall back to a configuration without the binding and show clear hints in system settings and request observation. |
| 18 | +- Added Japanese UI support and continued improving Chinese, English, and Japanese copy so the management area, request observation, and system settings pages feel more consistent across languages. |
| 19 | + |
| 20 | +## Changes Since v0.4.0 |
| 21 | + |
| 22 | +- Added `request-observation` entry protection logic covering User-Agent, Cloudflare Bot Management fields, ASN risk tiers, and verified bot information. |
| 23 | +- Added collect token generation, verification, and script-side injection so collection requests carry short-lived validation information issued by the server. |
| 24 | +- Changed collection endpoint behavior: bot requests are now written to the bot Analytics Engine dataset and no longer continue into the normal visit ingestion flow. |
| 25 | +- Added normal request Analytics Engine writes so the request observation page can compare the normal request path with abnormal diversion. |
| 26 | +- Added a request observation management page and connected it to the root management navigation, allowing system administrators to inspect request entry status from the global management area. |
| 27 | +- Added request observation demo data and page mocks so Demo Mode can show bot requests, normal requests, and abnormal request trends. |
| 28 | +- Added the Bot Analytics configuration model, validation, sensitive field redaction, and management APIs. |
| 29 | +- Improved the system settings structure with Analytics Engine configuration, guide dialogs, disabled-state hints, and save/delete feedback. |
| 30 | +- Optimized Analytics Engine query windows, time buckets, and compatibility handling to reduce offset and empty-window issues across time ranges. |
| 31 | +- Improved dashboard floating layers, drawers, tables, and export adapters to reduce click-through, layout shifting, and inconsistent complex table behavior. |
| 32 | +- Added a runtime configuration error page and strengthened root runtime secret requirements, making missing critical deployment configuration fail with clearer reasons. |
| 33 | +- Improved geo map loading, coordinate preservation, and geo table row height, making request details and map-related views more stable. |
| 34 | +- Standardized build, preview, deploy, publish, and operations scripts, reducing differences across the Cloudflare Worker lifecycle commands. |
| 35 | + |
| 36 | +## Developer Experience |
| 37 | + |
| 38 | +- Added `scripts/build.ts`, `scripts/deploy.ts`, `scripts/publish.ts`, `scripts/preview.ts`, and `scripts/ops.ts` as unified entry points for build, publish, preview, and operations workflows. |
| 39 | +- Refactored the Cloudflare build flow, replacing the old `scripts/cf-build.ts` and centralizing target environments, database bindings, and deployment parameters. |
| 40 | +- Added Analytics Engine availability detection and wrangler configuration override tests covering root and multi-environment deployment scenarios. |
| 41 | +- Expanded test coverage for bot protection, collect tokens, request observation, Bot Analytics management APIs, Analytics Engine writes, and request observation mocks. |
| 42 | +- Improved i18n checks, message generation, and unused copy pruning, and added type and copy coverage for the Japanese locale. |
| 43 | +- Adjusted Vitest and test helper configuration to improve stability for edge runtime, management API, and dashboard component tests. |
| 44 | + |
| 45 | +## Upgrade Notes |
| 46 | + |
| 47 | +- To enable request observation, first enable Analytics Engine in Cloudflare Workers & Pages, then redeploy InsightFlare so the bot and normal request datasets are bound. |
| 48 | +- After enabling Analytics Engine, enter your Cloudflare Account ID and an API Token with Analytics Engine read permission in system settings. |
| 49 | +- If Analytics Engine is not enabled on the current Cloudflare account, the app can still deploy and run, but request observation and Bot Analytics pages will show a setup-required or enable-required state. |
| 50 | +- This release strengthens collection entry security. Custom integrations that call `/collect` directly should use the latest tracking script or otherwise become compatible with the new signed collect token flow. |
| 51 | +- Make sure the deployment environment has a sufficiently strong `MAIN_SECRET` configured. Deployments without the root runtime secret are explicitly rejected to avoid unsafe default secrets. |
0 commit comments