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.

Sessions tell you how often people come back. Stickiness tells you what fraction of your monthly audience is active on any given day or week — a direct measure of engagement.

​
Quick start

# Session volume over the last 30 days
tell metrics sessions --range 30d

# Daily stickiness (DAU/MAU ratio)
tell metrics stickiness --range 30d --type daily

​
Session metrics

Session volume — total session count over time. Each session record counts as one. Unique sessions — distinct session IDs per time bucket. Filters out duplicate records for the same session. 
# Unique sessions, weekly buckets
tell metrics sessions --range 90d --granularity weekly --type unique
Via the API: 
# Session volume
curl "https://your-tell-server/api/v1/metrics/sessions?range=30d" \
  -H "Authorization: Bearer $TOKEN"

# Unique sessions
curl "https://your-tell-server/api/v1/metrics/sessions/unique?range=30d" \
  -H "Authorization: Bearer $TOKEN"

​
Top sessions

See which device types, countries, or operating systems generate the most sessions: 
# Top 10 device types by session count
curl "https://your-tell-server/api/v1/metrics/sessions/top?range=30d&property=device_type&limit=10" \
  -H "Authorization: Bearer $TOKEN"
Available groupings: device_type, country, operating_system, or any field in the context table.

​
Stickiness

Stickiness measures what proportion of your user base is active in a shorter window. Higher stickiness means better engagement. Daily stickiness = DAU / MAU. A value of 50% means half your monthly users visit every day. Weekly stickiness = WAU / MAU. A value of 80% means most monthly users visit at least once a week. 
# Daily stickiness with weekly granularity
tell metrics stickiness --range 90d --type daily --granularity weekly

# Weekly stickiness
tell metrics stickiness --range 90d --type weekly
Via the API: 
curl "https://your-tell-server/api/v1/metrics/stickiness/daily?range=30d" \
  -H "Authorization: Bearer $TOKEN"

​
Breakdowns and comparison

Session metrics support the same filtering and breakdowns as all other metrics — split by any field, compare to the previous period, and control time granularity. 
# Sessions by country, compared to previous period
tell metrics sessions --range 30d --breakdown country --compare previous