Start with access logs
CloudFront records page requests. Use those logs for analytics, then add the optional browser module to measure actions within a page.
Rainlytics
Self-hosted web analytics for sites served by CloudFront. Start with access
logs, then add a small first-party browser module when you need it.
Data stays in your AWS account
Raw logs and reports stay in your S3 buckets. You control access with your existing AWS permissions.
AWS charges by use
Storage and queries are charged by usage. Scheduled Athena queries have a minimum scan charge, even when the site has no traffic.
Read stored results
Scheduled queries write JSON summaries to S3. The CLI reads those files with an S3 GET request for each summary window.
Start here
Section titled “Start here”Getting startedInstall Rainlytics, deploy the AWS resources and read your first pageview report.
What Rainlytics isUnderstand the data flow and costs before deploying.
Command lineUse AWS credentials to read stored answers, calendar reports and ad-hoc queries.
Set up the pipeline
Section titled “Set up the pipeline”Log bucketStore raw CloudFront access logs with explicit retention and recovery settings.
Log deliveryConnect a CloudFront distribution to the raw log bucket.
Log tableDefine how Athena reads your CloudFront logs in S3.
Query workgroupSet a scan limit for each Athena query and choose where results are stored.
Summary scheduleCompute common questions and calendar reports on a schedule.
Read analytics
Section titled “Read analytics”RollupsRead pageviews, referrers, browsers, status codes, cache hit ratio and searches.
Calendar reportsRead versioned reports for closed days, weeks, months and years.
QueryRun ad-hoc SQL over raw access logs in Athena.
Counting visitorsUnderstand how visitor counts work and which address data is stored.
Report notificationsEmail selected calendar reports through Amazon SNS.
Add browser measurements
Section titled “Add browser measurements”Beacon pathReturn 204 for first-party event requests at the CloudFront edge.
Browser beaconReport SPA route changes, custom events, Web Vitals and JavaScript errors.
Collection-path abuseUnderstand filtering limits, request costs, WAF and budget alerts.