Ably Account Statistics/Stats
When you view your account dashboard or your app dashboard, you are automatically shown a summary of your account or app usage respectively. This includes a high level summary of your usage, billing information where relevant, and some charts for key metrics such as messages, connections, channels and bandwidth.
If you require detailed stats to view or download for your account or apps, you can find this by following the link beneath your summary stats table, or beneath your charts. See screenshots below.
1. From within your app or account dashboard, follow the link beneath to view or download your detailed stats
2. View your account stats by minute, hour, day or month, and choose to view all metrics or only the metrics that are active on your account
Reach out on our support portal if you have any further questions and we will be happy to help.
3. Accessing stats via the REST API
Here is an example curl command showing how to access stats for the current and previous minute using jq.
Here is a curl statement piped into jq which gives you the externalQueue stats. This counter records the Firehose stats. By specifying the second item in the JSON array we will get the last completed minute. The first item in the JSON array is the current minute, and therefore still increasing.
$ curl -u "api-key" \
https://rest.ably.io/stats?unit=minute\&limit=2 | jq '.[1].outbound.externalQueue.all'
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 2674 100 2674 0 0 16208 0 --:--:-- --:--:-- --:--:-- 16304
{
"count": 55,
"data": 715,
"uncompressedData": 715
}
If you want to see the current minute, specify element 0 in the JSON array as shown here:
curl -u "api-key" \
https://rest.ably.io/stats?unit=minute\&limit=2 | jq '.[0].outbound.externalQueue.all'
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 2678 100 2678 0 0 24974 0 --:--:-- --:--:-- --:--:-- 25028
{
"count": 42,
"data": 546,
"uncompressedData": 546
}
Further reading
- Find out what each of the metrics represents in your detailed stats page or downloaded document
- Find out about all connection, channel, message and rate limits on Ably accounts
- If you received an email about hitting a limit, find out what this means and what you can do about it
- Find out how to calculate what package you need to avoid hitting any limits using our handy limits calculator