Contents

Chapter 1

Features

This chapter covers the core features and capabilities of Event Tracker.

Features

  • Custom events — Track any event with arbitrary properties
  • User tracking — Associate events with user IDs and sessions
  • Page views — Built-in shortcut for page view tracking
  • SQLite storage — Indexed database with efficient querying
  • JSON storage — Append-only JSONL files for streaming pipelines
  • Aggregation — Group-by stats, counts, unique users, averages
  • Time windows — Query events from the last 7d, 24h, 30m, etc.
  • Batch tracking — Insert multiple events in a single transaction
  • CLI and library — Use from the command line or import as a module

Requirements

  • Python 3.10+
  • No external dependencies (stdlib only)
Chapter 2

Quick Start

Follow this guide to get Event Tracker up and running in your environment.

Quick Start

bash
# Track an event
python src/event_tracker.py track "signup" --user "user_123" --props '{"plan": "pro"}'

# Track a page view
python src/event_tracker.py track "page_view" --user "user_123" --props '{"page": "/pricing"}'

# Query recent events
python src/event_tracker.py query --last 7d

# Query by event name
python src/event_tracker.py query --event "signup" --limit 50

# View statistics
python src/event_tracker.py stats

# Count events
python src/event_tracker.py count --event "signup" --last 30d

Use as a Python Library

python
from event_tracker import SQLiteStore, track_event, track_page_view

store = SQLiteStore("my_events.db")

# Track custom events
track_event("purchase", user_id="user_456", properties={"amount": 49.99}, store=store)
track_page_view("/dashboard", user_id="user_456", store=store)

# Query events
events = store.query(event_name="purchase", limit=10)
stats = store.stats(group_by="event_name")

Storage Backends

BackendBest ForFile
SQLiteQuerying, aggregation, production useevents.db
JSONLStreaming, log pipelines, simplicityevents.jsonl
Chapter 3
🔒 Available in full product

Event Schema

Chapter 4
🔒 Available in full product

FAQ

You’ve reached the end of the free preview

Get the full Event Tracker and unlock everything.

All Chapters

Get the complete guide with every chapter unlocked, including code samples, diagrams, and best practices.

Full Tool Suite

Access all interactive tools with complete data, all workload profiles, and the full scenario library.

Source Files

Downloadable source code, configuration files, and working examples from every chapter.

Lifetime Updates

Free updates for life. Every new chapter, tool, and improvement included.

Buy Now — $19 →
📦 Free sample included — download another copy for the full product.
Event Tracker v1.0.0 — Free Preview