> ## 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.

# Analytics Overview

> How Tell turns raw events and logs into answers.

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](/analytics/page-views) |
| **Sessions**    | Session volume, unique sessions, stickiness (DAU/MAU)                | [Sessions & Stickiness](/analytics/sessions)   |
| **Events**      | Event counts, top events, property breakdowns, aggregations          | [Events](/analytics/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](/analytics/segments)                |
| **Predictions** | Churn risk, auto-segmentation, anomaly detection, forecasting        | [Predictions](/analytics/predictions/overview) |

## How it works

Every metric follows the same pattern: pick a time range, optionally add filters and breakdowns, and get back a time series.

```bash theme={null}
# 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
```

The same queries work through the [HTTP API](/api/queries), the [TUI](/tools/tui), and [boards](/analytics/boards).

## 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](/analytics/filtering) for the full reference.

## Boards

Combine multiple metrics into dashboards with [Boards](/analytics/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](/analytics/sql) directly against ClickHouse — scoped to your workspace and security-validated.