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.
Tell collects events, sessions, and logs from your app — then lets you query them as metrics, time series, and breakdowns. You get answers like “how many daily active users this week?” or “which events are most common?” without writing SQL.
What you can measure
| Category | Metrics | Learn more |
|---|
| Visitors | DAU, WAU, MAU, user count, location, device, OS | Visitors & Page Views |
| Sessions | Session volume, unique sessions, stickiness (DAU/MAU) | Sessions & Stickiness |
| Events | Event counts, top events, property breakdowns, aggregations | Events |
| Logs | Log volume by level, top logs by source/service | Part of the metrics API |
| Segments | Lifecycle (new, returning, dormant, churned) and engagement segments | Segments |
| Predictions | Churn risk, auto-segmentation, anomaly detection, forecasting | Predictions |
How it works
Every metric follows the same pattern: pick a time range, optionally add filters and breakdowns, and get back a time series.
# Daily active users over the last 30 days
tell metrics dau --range 30d
# Event counts broken down by device type
tell metrics events --range 7d --breakdown device_type
# Compare this week's sessions to last week
tell metrics sessions --range 7d --compare previous
Filtering and breakdowns
All metrics support the same filtering system — 15 operators, breakdowns by any field, time granularity from minute to yearly, and period comparison. See Filtering & Breakdowns for the full reference.
Boards
Combine multiple metrics into dashboards with Boards. Each board contains metric blocks that you configure with their own time ranges, filters, and visualizations.
SQL access
For queries that go beyond built-in metrics, use raw SQL directly against ClickHouse — scoped to your workspace and security-validated.
