> For the complete documentation index, see [llms.txt](https://docs.digitalapi.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digitalapi.ai/marketplace/concepts/concept-analytics.md).

# Analytics & reporting

Analytics and reporting is the adoption lens over your marketplace: it turns the usage the gateway records into a view of who is adopting what and how it performs. Provider analytics gives product owners built-in dashboards, while custom reports build the specific slices teams watch. Both read the same underlying data, so the picture stays consistent.

![Figure. From metered calls to the decisions they inform.](/files/YXVus9yiFNJLIuJB6Tqk)

![Figure. Provider analytics showing adoption and traffic.](/files/gXX2gNT2fRJ7slOD0Wjk)

### Provider analytics

Provider analytics answers the product owner's first questions: what is being adopted, and how healthy is it. The built-in dashboards cover adoption, traffic, the top products, and subscriber health.

* **Adoption:** new subscriptions and active apps over time.
* **Traffic:** call volume, error rates, and latency across APIs and products.
* **Top products:** which products and APIs drive the most usage.
* **Subscriber health:** active, idle, and at-risk subscriptions at a glance.

Astra reports what the gateway meters. The marketplace is not in the request path, so freshness depends on how usage is collected: continuous collection is close to real time, batched collection carries a delay.

### Custom reports

Beyond the dashboards, custom reports answer specific questions through a filtered, saved view. You pick dimensions and metrics, choose a time window, and the report reruns on demand. This is the right tool when a dashboard is too broad: scope a view to one release window, one environment, or one product line, then share that link.

<details>

<summary>More detail</summary>

* **Dimensions:** group by service, environment, product, status, or route.
* **Metrics:** request count, error rate, and latency percentiles.
* **Time window:** bound a report to a release, an incident, or a billing period.
* **Saved and shareable:** a saved report reruns on demand and shares a stable link, so a team watches the same slice over time.

</details>

{% hint style="info" %}
**Note:** analytics reports on usage; turning that usage into revenue (plans, invoices, and payouts) is covered separately under monetization.
{% endhint %}

> **How-to:** for step-by-step configuration of dashboards and custom reports, see the How-to guides.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.digitalapi.ai/marketplace/concepts/concept-analytics.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
