Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tell.rs/llms.txt

Use this file to discover all available pages before exploring further.

Know how many people use your product each day, week, or month. Tell counts unique visitors (by device ID) and gives you DAU, WAU, and MAU out of the box.

​
Quick start

# Daily active users, last 30 days
tell metrics dau --range 30d

# Weekly active users, broken down by country
tell metrics wau --range 90d --breakdown country
Or via the API: 
curl "https://your-tell-server/api/v1/metrics/dau?range=30d" \
  -H "Authorization: Bearer $TOKEN"

​
Metrics

DAU (daily active users) — distinct visitors per day. If a user visits three times in one day, they count once. WAU (weekly active users) — distinct visitors per rolling 7-day window. MAU (monthly active users) — distinct visitors per rolling 30-day window. User count — total user records over time from the users table, distinct from active user metrics.

​
Breakdowns

Split any visitor metric by a dimension to see where your users come from: 
# Visitors by device type (desktop, mobile, tablet)
tell metrics dau --range 30d --breakdown device_type

# Visitors by operating system
tell metrics dau --range 30d --breakdown operating_system

# Visitors by country
tell metrics dau --range 30d --breakdown country
Via the API, add &breakdown=device_type to any active user endpoint.

​
Comparing periods

See how visitor numbers changed compared to the previous period or same period last year: 
# DAU this month vs last month
tell metrics dau --range 30d --compare previous

# Year-over-year comparison
tell metrics mau --range 90d --compare yoy
The response includes the current total, previous total, absolute change, and percent change.

​
Drill-down

When you see a spike or drop in visitors, drill into the raw data to see which specific users were active: 
curl "https://your-tell-server/api/v1/metrics/dau/raw?range=7d&limit=50" \
  -H "Authorization: Bearer $TOKEN"
This returns individual device IDs within the time range, so you can investigate further.

​
Time ranges and granularity

All visitor metrics support the full set of time ranges and granularity options — from minute-level resolution up to yearly buckets, with predefined ranges like today, wtd, mtd, ytd, or custom date ranges.