> For the complete documentation index, see [llms.txt](https://docs.helodata.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.helodata.com/dashboard/statistics.md).

# Statistics & usage

The Statistics tab shows what you used, where it went, and what failed. Available per-product; the metrics differ slightly by product.

## Where to find it

| Path                         | Shows                                   |
| ---------------------------- | --------------------------------------- |
| **Residential → Statistics** | Residential traffic + errors            |
| **Mobile → Statistics**      | Mobile traffic + carrier breakdown      |
| **ISP → Statistics**         | Per-IP usage + batch health             |
| **Dashboard → Statistics**   | Account-wide rollup across all products |

\[screenshot: Statistics view with charts]

## Common views

### Traffic over time

Stacked area chart, sliceable by sub-user / region / ASN / tag. Hover for exact values.

Default range: last 24h at 1-min granularity. Stretch the range and the chart downsamples — see [Granularity](/api-reference/traffic.md#granularity).

### Top destinations

Table of domains by traffic and request count. Click a row to drill into:

* Per-IP traffic to that domain
* Status code histogram (200 vs 4xx vs 5xx)
* Recent sample requests

Useful for spotting which targets dominate your bill or which return the most errors.

### Top countries (gateway products)

Where your traffic exits. Stacked by sub-user if a request had targeting.

### Top ASNs / carriers (mobile)

Carrier distribution for mobile traffic. A skewed carrier mix can be a sign your `asn` targeting isn't doing what you think.

### Error breakdown

Status code histogram + `X-Helodata-Error-Code` breakdown. Click a slice to see sample failing requests.

### Concurrency

Time-series of peak concurrent connections vs your sub-user limit. If this is hitting the ceiling regularly, you need either more sub-users or a plan upgrade.

### ISP per-IP table

For ISP, the headline view is a sortable table of every IP in your batches with columns:

* IP
* Country / city / ASN
* Requests today
* Error rate
* Health score (0–100)
* Last used

Sort by health ascending to spot bad apples; by "Last used" to spot idle IPs you could release.

## Filters

The top of every Statistics page has:

* **Date range** — presets or custom
* **Sub-user** — multi-select
* **Tag** — match `X-Helodata-Tag` values you set on requests

Filters apply to all panels on the page.

## Exporting

The **Export** button on any panel downloads a CSV / JSON of the data currently rendered. For scheduled exports to S3 or email, use [Reports](/api-reference/reports.md).

## Alerts

Pair stats with alerts under **Settings → Alerts**. Common rules:

* Daily traffic > X GB
* Error rate > Y% in Z minutes
* Concurrency at 90% of limit
* ISP IP health < 80
* Carrier repinning rate > 15%

Delivered by email and (optional) Slack webhook.

## Reconciling with the API

Everything in the UI is also available via the [Traffic API](/api-reference/traffic.md). The numbers must match — if they don't, open a ticket; that's a bug.

## Common pitfalls

* **Comparing trial vs paid traffic** — trial bandwidth is metered separately and shown in a different panel. Don't accidentally read trial-only data when sizing production usage.
* **Tag filter sticking** — if your dashboard mysteriously shows tiny numbers, check the tag filter at the top isn't accidentally set.
* **Downsampling artefacts** — for views older than 14 days, 5-min buckets can hide short-lived spikes. Use the API for high-fidelity historical analysis.