Skip to content

upstash/core-analytics

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

45 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

@upstash/core-analytics

Serverless Analytics for Redis

This library offers some low level building blocks to record and analyze custom events in Redis. It's main purpose is to provide a simple way to record and query events in Redis without having to worry about the underlying data structure so we can build more advanced analytics features on top of it.

The quickstart below is slightly outdated. We're working on it.


Quickstart

  1. Create a redis database

Go to console.upstash.com/redis and create a new global database.

After creating the db, copy the UPSTASH_REDIS_REST_URL and UPSTASH_REDIS_REST_TOKEN to your .env file.

  1. Install @upstash/core-analytics in your project
npm install @upstash/analytics @upstash/redis
  1. Create an analytics client
import { Analytics } from "@upstash/core-analytics";
import { Redis } from "@upstash/redis";

const analytics = new Analytics({
  redis: Redis.fromEnv(),
  window: "1d",
});
  1. Ingest some events

An event consists of a time field and any additional key-value pairs that you can use to record any information you want.

const event = {
  time: Date.now() // optional (default: Date.now())
  userId: "chronark",
  page: "/auth/login",
  country: "DE",
}

await analytics.ingest("pageviews", event);
  1. Query your events
const result = await analytics.query("pageviews");

Development

This project uses bun for dependency management.

Install dependencies

bun install

Build

bun build

Database Schema

All metrics are stored in Redis Hash data types and sharded into buckets based on the window option.

@upstash/analytics:{TABLE}:{TIMESTAMP}
  • TABLE is a namespace to group events together. ie for managing multiple projects int a single database
  • TIMESTAMP is the starting timestamp of each window

The field of each hash is a serialized JSON object with the user's event data and the value is the number of times this event has been recorded.

{
  "{\"page\": \"/auth/login\",\"country\": \"DE\"}": 5,
  "{\"page\": \"/auth/login\",\"country\": \"US\"}": 2
}