Statistics and usage
There are two ways to filter the Mapbox usage data on your Statistics page:
- By date: Choose a standard period (such as week or month) or enter a custom date range. All dates are in UTC (Greenwich Mean Time). Usage data will be available on the Statistics page within 24 hours.
- By access token: See usage for all access tokens or one specific access token. Legacy SDKs for Mobile statistics are not available when filtering by access token. To see Legacy SDKs for Mobile statistics, filter by All tokens and connected apps.
Your account usage is organized by product on your Statistics page. For each product, you'll see the number of metered units for the token and time period selected.
You will only see statistics for the products you’ve used within the specified time period and with the specified token. For more detailed explanations of how usage is metered for each product, see Pricing by products.
For many products, you can load additional metrics about the Countries, Browsers, Domains, and Tileset IDs associated with your requests. These additional metrics are presented as percentages of the total number of metered units for the specified time period and token.
Additional metrics are not available for products that are metered by user count (such as Maps SDK for Mobile). They are also not available for time periods exceeding 31 days.
Have questions about the Statistics page? Let our Support team know- we're happy to help!
When you see Not set as an additional metric value, it means that for some requests we are not able to find a value for that metric. With the additional metric Domains, for example, Not set means the request did not include a referrer from which we could parse a domain, which may because your requests are not coming from web browsers, or because you are using an legacy version of GL JS. Upgrading to the latest version of GL JS should reduce the number of Not set domains and is a requirement for implementing URL restrictions.
When you see Other as an additional metric value, it means we are not able to convert the value to a legible display format. For example, for the additional metric Browsers, Other means we are not able to simplify the request's user agent to a display format.
The names of deleted tokens do not show up in the drop-down filter list. Statistics tied to a deleted token will be aggregated in the All tokens and connected apps view. It is not possible to isolate statistics for a token after it has been deleted.
If you've set the custom date on your Statistics page to match your billing cycle and notice a discrepancy in the values of services you were billed for, it's most likely an issue with timezones. Requests attributed to your billing period that were not invoiced during that month will roll over to the next invoice.
We don't yet support an export feature on the Statistics page but would love to hear your feature requests around a CSV download option - contact us to share your use case.