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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.helodata.com/dashboard/statistics.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.