Serverless Analytics

Track website visitors with Serverless Analytics using Kinesis, Lambda, and TypeScript.
Alternatives To Serverless Analytics
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Localstack46,4324113 hours ago44July 22, 2022338otherPython
💻 A fully functional local AWS cloud stack. Develop and test your cloud & Serverless apps offline!
Serverless44,4771,6188304 hours ago1,987September 19, 2022998mitJavaScript
⚡ Serverless Framework – Build web, mobile and IoT applications with serverless architectures using AWS Lambda, Azure Functions, Google CloudFunctions & more! –
Pulumi15,5021323472 hours ago3,838September 19, 20221,718apache-2.0Go
Pulumi - Universal Infrastructure as Code. Your Cloud, Your Language, Your Way 🚀
Sst12,88844 hours ago681September 23, 2022621mitJavaScript
💥 SST makes it easy to build full-stack serverless apps.
Awesome Aws11,283
22 days ago1December 21, 201563otherPython
A curated list of awesome Amazon Web Services (AWS) libraries, open source repos, guides, blogs, and other resources. Featuring the Fiery Meter of AWSome.
2 days ago19April 25, 2021167otherJavaScript
Serverless Examples – A collection of boilerplates and examples of serverless architectures built with the Serverless Framework on AWS Lambda, Microsoft Azure, Google Cloud Functions, and more.
Chalice9,5971263122 days ago86June 01, 2022430apache-2.0Python
Python Serverless Microframework for AWS
Serverless Application Model8,965841518 hours ago59June 07, 2022133apache-2.0Python
The AWS Serverless Application Model (AWS SAM) transform is a AWS CloudFormation macro that transforms SAM templates into CloudFormation templates.
Up8,687681325 days ago11March 02, 2018291mitGo
Deploy infinitely scalable serverless apps, apis, and sites in seconds to AWS.
Midway6,52131478 hours ago204August 16, 2022125mitTypeScript
🍔 A Node.js Serverless Framework for front-end/full-stack developers. Build the application for next decade. Works on AWS, Alibaba Cloud, Tencent Cloud and traditional VM/Container. Super easy integrate with React and Vue. 🌈
Alternatives To Serverless Analytics
Select To Compare

Alternative Project Comparisons

Serverless Analytics ⚡️

MIT License Read Tutorial

Example project and proof of concept for a personal serverless Google Analytics clone to track website visitors. You can read more about Serverless Analytics with Amazon Kinesis and AWS Lambda on


After deploying the service you will have an HTTP endpoint using Amazon API Gateway that accepts requests and puts them into a Kinesis Stream. A Lambda function processes the stream and writes basic metrics about how many visitors you have per absolute URL to DynamoDB.

To access the tracked data, a basic dashboard with a JSON API is included as well. This should be a perfect starting point for you to create your own analytics service.

Tracking Service

  • Amazon Kinesis to stream visitor events
  • Amazon API Gateway for Kinesis HTTP proxy
  • Amazon DynamoDB for data storage
  • AWS Lambda to process visitor events



The use of two API Gateways (data tracking and reading) is intended. You might have different settings for tracking and data access when you build something meaningful out of this example.


All settings can be customized in the serverless.yml configuration file. You can easily change the DynamoDB Table, Kinesis Stream and API Gateway tracking resource name:

service: sls-analytics

      website: ${self:service}-website-example
      dashboard: ${self:service}-website-dashboard
    resource: track
    dynamodb: ${self:service}-data
    kinesis: ${self:service}-stream

The S3 Bucket configuration is only needed for the included example website and dashboard. If you don't need the examples, have a look at the scripts/ file and disable the deployment and remove the CloudFormation resources from the serverless.yml file.

Amazon requires unique names for S3 buckets and other resources. Please rename at least the service before you try to deploy the example!


s3sync requires you to set AWS access keys as environmental variables.


Deploy script uses jq to read variables from generated output during deployment process. If you don't have jq installed, download it here.

Running yarn deploy will trigger a serverless deployment. After the output of your CloudFormation Stack is available, the included static websites will be generated (using the hostname from the stack output) and uploaded to the configured S3 buckets. As the last step, the deploy process will display the URLs of the example website and dashboard:

# Install dependencies
$ > yarn install
# Deploy 
$ > yarn deploy



The website includes a simple HTML file, some stylings, and a few JavaScript lines that send a request to the tracking API on every page load. Open the URL in a web browser, hit a few times the refresh button and take a look at the DynamoDB table or the dashboard URL.


Basically, tracking is nothing more than sending a HTTP request to the API with a set of payload information (currently url, date, name, and a websiteId). Normally you would have an additional non-JS fallback, like an image e.g., but a simple fetch call does the job for now:

    method: "POST",
    body: JSON.stringify(
        date: new Date().getTime(),
        name: document.title,
        url: location.href,
        website: 'yfFbTv1GslRcIkUsWpa7'
    headers: new Headers({ "Content-Type": "application/json" })

Data Access

An example dashboard to access tracked data is included and deployed to S3. The URL will be displayed after the deploy task. You can access the metrics using basic curl requests as well. Just provide the website and date parameters:

Top Content

The ranking resource scans the DynamoDB for pages with the most hits on a specific date value:

$ > curl

    "name": "Example Website - Serverless Analytics",
    "url": "",
    "value": 19
    "name": "Example Website - Serverless Analytics",
    "url": "",
    "value": 10
    "name": "Example Website - Serverless Analytics",
    "url": "",
    "value": 4

Requests per URL

The series resource scans the DynamoDB for data about a specific url in a given date period.

$ > curl

    "date": "MINUTE:2017-08-25T13:33",
    "value": 1
    "date": "MINUTE:2017-08-25T13:37",
    "value": 1
    "date": "MINUTE:2017-08-25T13:46",
    "value": 14
    "date": "MINUTE:2017-08-25T13:52",
    "value": 1

Date Parameter

The DynamoDB stores the absolute hits number for the dimensions YEAR, MONTH, DATE, HOUR, and MINUTE per default. This may cause lots of write capacities when processing events, but with the serverless-dynamodb-autoscaling plugin DynamoDB will scale the capacities when needed.

All dates are UTC values!




Feel free to use the code, it's released using the MIT license.


You are welcome to contribute to this project! 😘

To make sure you have a pleasant experience, please read the code of conduct. It outlines core values and beliefs and will make working together a happier experience.

Popular Serverless Projects
Popular Amazon Web Services Projects
Popular Cloud Computing Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Amazon Web Services
Lambda Functions