analytics

Analytics and metrics platform for measuring workflow performance, business outcomes, and user behavior with real-time dashboards and reports.

Overview

The analytics primitive provides comprehensive tracking, measurement, and analysis of all platform activities, from function execution times to business KPIs and user engagement metrics.

SDK Object Mapping

This primitive maps to the send SDK object - one of the 8 core platform objects:

import { send, analytics } from 'sdk.do'

// Track events via send
await send('analytics.track', {
  event: 'order.completed',
  userId: 'user-123',
  data: { orderId: '123', total: 99.99 },
})

// Query metrics
const revenue = await analytics.metric('revenue', {
  timeRange: 'last-30-days',
  groupBy: 'day',
})

// Real-time dashboard
await analytics.dashboard('sales', {
  metrics: ['revenue', 'orders', 'conversion-rate'],
})

Subdomain Architecture

The analytics primitive uses infinite free subdomains for specialized analytics types:

analytics.do                       # Root - General analytics
├── kpis.analytics.do              # KPI tracking (also kpis.do)
├── performance.analytics.do       # Performance monitoring (also performance.do)
├── trace.analytics.do             # Distributed tracing (also trace.do)
└── experiments.analytics.do       # A/B testing (also experiments.do)

Child Primitives

kpis - Key Performance Indicator tracking
performance - Performance monitoring and Core Web Vitals
trace - Distributed tracing and observability
experiments - A/B testing and experimentation

Quick Example

import { analytics } from 'sdk.do'

// Track event
analytics.track('order.completed', {
  orderId: '123',
  total: 99.99,
  userId: 'user-456',
})

// Query metrics
const revenue = await analytics.metric('revenue', {
  timeRange: 'last-30-days',
  groupBy: 'day',
})

// Create dashboard
analytics.dashboard('sales', {
  metrics: ['revenue', 'orders', 'conversion-rate'],
  charts: ['line', 'bar', 'funnel'],
})

Core Capabilities

Event Tracking - Capture custom events and user actions
Metrics & KPIs - Define and monitor business metrics
Real-Time Dashboards - Live visualization of data
Funnel Analysis - Track conversion funnels and drop-offs
Performance Monitoring - Function execution and latency tracking

Access Methods

SDK

TypeScript/JavaScript library for analytics

await analytics.track('order.completed', { orderId: '123', total: 99.99 })

→ SDK Documentation

CLI

Command-line tool for analytics queries

do analytics query revenue --time-range last-30-days --group-by day

→ CLI Documentation

API

REST/RPC endpoints for analytics data

curl -X POST https://api.do/v1/analytics/track -d '{"event":"order.completed","data":{...}}'

→ API Documentation

MCP

Model Context Protocol for AI-driven analytics

Track an order.completed event with order ID 123 and total $99.99

→ MCP Documentation

Child Primitives

kpis - Key Performance Indicator tracking
performance - Performance monitoring and Core Web Vitals
trace - Distributed tracing and observability
experiments - A/B testing and experimentation

events - Event tracking and publishing
database - Data storage for analytics
send - Event emission (SDK object mapping)

analytics

On this page