Real-time analytics
IMPORTANT: Unlike other Fastly APIs, the base URL for real-time analytics is https://rt.fastly.com.
The real-time analytics API offers a standardized set of data about traffic received by a specified service in one-second time periods up to the last complete second.
Data model
AggregateDelay | integer | How long the system will wait before aggregating messages for each second. The most recent data returned will have happened at the moment of the request, minus the aggregation delay. |
Data | array | A list of records, each representing one second of time. |
Timestamp | integer | Value to use for subsequent requests. |
Record data model
A list of records, each representing one second of time. The Data property provides access to measurement data for that time period, grouped in various ways.
aggregated | object | Aggregates measurements across all Fastly data centers. |
datacenter | object | Groups measurements by data center. See the data centers API for details of data center identifiers. |
recorded | integer | The Unix timestamp at which this record's data was generated. |
Measurements data model
Statistics that have occurred since the last request.
The miss_histogram object is a histogram. Each key represents the upper bound of a span of 10 milliseconds and the values represent the number of requests to origin during that 10ms period. Any origin request that takes more than 60 seconds to return will be in the 60000 bucket.
data | object | The results of the query, grouped by service (and optionally, region), and aggregated over the appropriate time span. |
meta | object | Meta information about the scope of the query in a human readable format. |
msg | string | If the query was not successful, this will provide a string that explains why. |
status | string | Whether or not we were able to successfully execute the query. |
Endpoints
Rate limiting
The real-time analytics API is rate limited internally. However, it is also cached behind Fastly with an expiration time of 1s. Under normal use there should be no reason for customers to hit that rate limit.