Origin Inspector Real-time API

IMPORTANT: Unlike other Fastly APIs, the base URL for Origin Inspector Real-time API is https://rt.fastly.com.

Origin Inspector offers a real-time JSON-formatted data stream providing visibility into responses delivered from your origin servers to Fastly. The API offers a standardized set of data to report in real-time every origin response, byte, and status code received by a specified service in one-second periods up to the last complete second.

IMPORTANT: Origin Inspector is an optional upgrade to Fastly service plans and must be enabled for each service using the enablement API.

Origin Inspector offers a real-time JSON-formatted data stream providing visibility into responses delivered from your origin servers to Fastly. The API offers a standardized set of data to report in real-time every origin response, byte, and status code received by a specified service in one-second periods up to the last complete second.

Data model

AggregateDelayintegerOffset of entry timestamps from the current time due to processing time.
DataarrayA list of report entries, each representing one second of time.
TimestampintegerValue to use for subsequent requests.

Measurements data model

A measurements object provides a count of the total number of responses received by Fastly from your origin servers in the reported time period, for the relevant POP and backend name as specified in the entry. It also includes the number of responses for specific HTTP response status codes and for status code ranges. This dataset is sparse: only the keys with non-zero values will be included in the record. Where a specific status code does not have a field in this model (e.g., 429 Too Many Requests), any responses with that code will be counted as part of the range count (4xx in this case) but will not be separately identified in the data.

all_latency_0_to_1msintegerNumber of responses with latency between 0 and 1 millisecond received for origin requests made by all sources.
all_latency_10000_to_60000msintegerNumber of responses with latency between 10,000 and 60,000 milliseconds received for origin requests made by all sources.
all_latency_1000_to_5000msintegerNumber of responses with latency between 1,000 and 5,000 milliseconds received for origin requests made by all sources.
all_latency_100_to_250msintegerNumber of responses with latency between 100 and 250 milliseconds received for origin requests made by all sources.
all_latency_10_to_50msintegerNumber of responses with latency between 10 and 50 milliseconds received for origin requests made by all sources.
all_latency_1_to_5msintegerNumber of responses with latency between 1 and 5 milliseconds received for origin requests made by all sources.
all_latency_250_to_500msintegerNumber of responses with latency between 250 and 500 milliseconds received for origin requests made by all sources.
all_latency_5000_to_10000msintegerNumber of responses with latency between 5,000 and 10,000 milliseconds received for origin requests made by all sources.
all_latency_500_to_1000msintegerNumber of responses with latency between 500 and 1,000 milliseconds received for origin requests made by all sources.
all_latency_50_to_100msintegerNumber of responses with latency between 50 and 100 milliseconds received for origin requests made by all sources.
all_latency_5_to_10msintegerNumber of responses with latency between 5 and 10 milliseconds received for origin requests made by all sources.
all_latency_60000msintegerNumber of responses with latency of 60,000 milliseconds and above received for origin requests made by all sources.
all_resp_body_bytesintegerNumber of body bytes received for origin requests made by all sources.
all_resp_header_bytesintegerNumber of header bytes received for origin requests made by all sources.
all_responsesintegerNumber of responses received for origin requests made by all sources.
all_status_1xxintegerNumber of 1xx "Informational" category status codes delivered received for origin requests made by all sources.
all_status_200integerNumber of responses received with status code 200 (Success) received for origin requests made by all sources.
all_status_204integerNumber of responses received with status code 204 (No Content) received for origin requests made by all sources.
all_status_206integerNumber of responses received with status code 206 (Partial Content) received for origin requests made by all sources.
all_status_2xxintegerNumber of 2xx "Success" status codes received for origin requests made by all sources.
all_status_301integerNumber of responses received with status code 301 (Moved Permanently) received for origin requests made by all sources.
all_status_302integerNumber of responses received with status code 302 (Found) received for origin requests made by all sources.
all_status_304integerNumber of responses received with status code 304 (Not Modified) received for origin requests made by all sources.
all_status_3xxintegerNumber of 3xx "Redirection" codes received for origin requests made by all sources.
all_status_400integerNumber of responses received with status code 400 (Bad Request) received for origin requests made by all sources.
all_status_401integerNumber of responses received with status code 401 (Unauthorized) received for origin requests made by all sources.
all_status_403integerNumber of responses received with status code 403 (Forbidden) received for origin requests made by all sources.
all_status_404integerNumber of responses received with status code 404 (Not Found) received for origin requests made by all sources.
all_status_416integerNumber of responses received with status code 416 (Range Not Satisfiable) received for origin requests made by all sources.
all_status_429integerNumber of responses received with status code 429 (Too Many Requests) received for origin requests made by all sources.
all_status_4xxintegerNumber of 4xx "Client Error" codes received for origin requests made by all sources.
all_status_500integerNumber of responses received with status code 500 (Internal Server Error) received for origin requests made by all sources.
all_status_501integerNumber of responses received with status code 501 (Not Implemented) received for origin requests made by all sources.
all_status_502integerNumber of responses received with status code 502 (Bad Gateway) received for origin requests made by all sources.
all_status_503integerNumber of responses received with status code 503 (Service Unavailable) received for origin requests made by all sources.
all_status_504integerNumber of responses received with status code 504 (Gateway Timeout) received for origin requests made by all sources.
all_status_505integerNumber of responses received with status code 505 (HTTP Version Not Supported) received for origin requests made by all sources.
all_status_5xxintegerNumber of 5xx "Server Error" codes received for origin requests made by all sources.
compute_latency_0_to_1msintegerNumber of responses with latency between 0 and 1 millisecond for origin received by the Compute platform.
compute_latency_10000_to_60000msintegerNumber of responses with latency between 10,000 and 60,000 milliseconds for origin received by the Compute platform.
compute_latency_1000_to_5000msintegerNumber of responses with latency between 1,000 and 5,000 milliseconds for origin received by the Compute platform.
compute_latency_100_to_250msintegerNumber of responses with latency between 100 and 250 milliseconds for origin received by the Compute platform.
compute_latency_10_to_50msintegerNumber of responses with latency between 10 and 50 milliseconds for origin received by the Compute platform.
compute_latency_1_to_5msintegerNumber of responses with latency between 1 and 5 milliseconds for origin received by the Compute platform.
compute_latency_250_to_500msintegerNumber of responses with latency between 250 and 500 milliseconds for origin received by the Compute platform.
compute_latency_5000_to_10000msintegerNumber of responses with latency between 5,000 and 10,000 milliseconds for origin received by the Compute platform.
compute_latency_500_to_1000msintegerNumber of responses with latency between 500 and 1,000 milliseconds for origin received by the Compute platform.
compute_latency_50_to_100msintegerNumber of responses with latency between 50 and 100 milliseconds for origin received by the Compute platform.
compute_latency_5_to_10msintegerNumber of responses with latency between 5 and 10 milliseconds for origin received by the Compute platform.
compute_latency_60000msintegerNumber of responses with latency of 60,000 milliseconds and above for origin received by the Compute platform.
compute_resp_body_bytesintegerNumber of body bytes for origin received by the Compute platform.
compute_resp_header_bytesintegerNumber of header bytes for origin received by the Compute platform.
compute_responsesintegerNumber of responses for origin received by the Compute platform.
compute_status_1xxintegerNumber of 1xx "Informational" status codes for origin received by the Compute platform.
compute_status_200integerNumber of responses received with status code 200 (Success) for origin received by the Compute platform.
compute_status_204integerNumber of responses received with status code 204 (No Content) for origin received by the Compute platform.
compute_status_206integerNumber of responses received with status code 206 (Partial Content) for origin received by the Compute platform.
compute_status_2xxintegerNumber of 2xx "Success" status codes for origin received by the Compute platform.
compute_status_301integerNumber of responses received with status code 301 (Moved Permanently) for origin received by the Compute platform.
compute_status_302integerNumber of responses received with status code 302 (Found) for origin received by the Compute platform.
compute_status_304integerNumber of responses received with status code 304 (Not Modified) for origin received by the Compute platform.
compute_status_3xxintegerNumber of 3xx "Redirection" codes for origin received by the Compute platform.
compute_status_400integerNumber of responses received with status code 400 (Bad Request) for origin received by the Compute platform.
compute_status_401integerNumber of responses received with status code 401 (Unauthorized) for origin received by the Compute platform.
compute_status_403integerNumber of responses received with status code 403 (Forbidden) for origin received by the Compute platform.
compute_status_404integerNumber of responses received with status code 404 (Not Found) for origin received by the Compute platform.
compute_status_416integerNumber of responses received with status code 416 (Range Not Satisfiable) for origin received by the Compute platform.
compute_status_429integerNumber of responses received with status code 429 (Too Many Requests) for origin received by the Compute platform.
compute_status_4xxintegerNumber of 4xx "Client Error" codes for origin received by the Compute platform.
compute_status_500integerNumber of responses received with status code 500 (Internal Server Error) for origin received by the Compute platform.
compute_status_501integerNumber of responses received with status code 501 (Not Implemented) for origin received by the Compute platform.
compute_status_502integerNumber of responses received with status code 502 (Bad Gateway) for origin received by the Compute platform.
compute_status_503integerNumber of responses received with status code 503 (Service Unavailable) for origin received by the Compute platform.
compute_status_504integerNumber of responses received with status code 504 (Gateway Timeout) for origin received by the Compute platform.
compute_status_505integerNumber of responses received with status code 505 (HTTP Version Not Supported) for origin received by the Compute platform.
compute_status_5xxintegerNumber of 5xx "Server Error" codes for origin received by the Compute platform.
latency_0_to_1msintegerNumber of responses from origin with latency between 0 and 1 millisecond.
latency_10000_to_60000msintegerNumber of responses from origin with latency between 10,000 and 60,000 milliseconds.
latency_1000_to_5000msintegerNumber of responses from origin with latency between 1,000 and 5,000 milliseconds.
latency_100_to_250msintegerNumber of responses from origin with latency between 100 and 250 milliseconds.
latency_10_to_50msintegerNumber of responses from origin with latency between 10 and 50 milliseconds.
latency_1_to_5msintegerNumber of responses from origin with latency between 1 and 5 milliseconds.
latency_250_to_500msintegerNumber of responses from origin with latency between 250 and 500 milliseconds.
latency_5000_to_10000msintegerNumber of responses from origin with latency between 5,000 and 10,000 milliseconds.
latency_500_to_1000msintegerNumber of responses from origin with latency between 500 and 1,000 milliseconds.
latency_50_to_100msintegerNumber of responses from origin with latency between 50 and 100 milliseconds.
latency_5_to_10msintegerNumber of responses from origin with latency between 5 and 10 milliseconds.
latency_60000msintegerNumber of responses from origin with latency of 60,000 milliseconds and above.
resp_body_bytesintegerNumber of body bytes from origin.
resp_header_bytesintegerNumber of header bytes from origin.
responsesintegerNumber of responses from origin.
status_1xxintegerNumber of 1xx "Informational" status codes delivered from origin.
status_200integerNumber of responses received with status code 200 (Success) from origin.
status_204integerNumber of responses received with status code 204 (No Content) from origin.
status_206integerNumber of responses received with status code 206 (Partial Content) from origin.
status_2xxintegerNumber of 2xx "Success" status codes delivered from origin.
status_301integerNumber of responses received with status code 301 (Moved Permanently) from origin.
status_302integerNumber of responses received with status code 302 (Found) from origin.
status_304integerNumber of responses received with status code 304 (Not Modified) from origin.
status_3xxintegerNumber of 3xx "Redirection" codes delivered from origin.
status_400integerNumber of responses received with status code 400 (Bad Request) from origin.
status_401integerNumber of responses received with status code 401 (Unauthorized) from origin.
status_403integerNumber of responses received with status code 403 (Forbidden) from origin.
status_404integerNumber of responses received with status code 404 (Not Found) from origin.
status_416integerNumber of responses received with status code 416 (Range Not Satisfiable) from origin.
status_429integerNumber of responses received with status code 429 (Too Many Requests) from origin.
status_4xxintegerNumber of 4xx "Client Error" codes delivered from origin.
status_500integerNumber of responses received with status code 500 (Internal Server Error) from origin.
status_501integerNumber of responses received with status code 501 (Not Implemented) from origin.
status_502integerNumber of responses received with status code 502 (Bad Gateway) from origin.
status_503integerNumber of responses received with status code 503 (Service Unavailable) from origin.
status_504integerNumber of responses received with status code 504 (Gateway Timeout) from origin.
status_505integerNumber of responses received with status code 505 (HTTP Version Not Supported) from origin.
status_5xxintegerNumber of 5xx "Server Error" codes delivered from origin.
waf_latency_0_to_1msintegerNumber of responses with latency between 0 and 1 millisecond received for origin requests made by the Fastly WAF.
waf_latency_10000_to_60000msintegerNumber of responses with latency between 10,000 and 60,000 milliseconds received for origin requests made by the Fastly WAF.
waf_latency_1000_to_5000msintegerNumber of responses with latency between 1,000 and 5,000 milliseconds received for origin requests made by the Fastly WAF.
waf_latency_100_to_250msintegerNumber of responses with latency between 100 and 250 milliseconds received for origin requests made by the Fastly WAF.
waf_latency_10_to_50msintegerNumber of responses with latency between 10 and 50 milliseconds received for origin requests made by the Fastly WAF.
waf_latency_1_to_5msintegerNumber of responses with latency between 1 and 5 milliseconds received for origin requests made by the Fastly WAF.
waf_latency_250_to_500msintegerNumber of responses with latency between 250 and 500 milliseconds received for origin requests made by the Fastly WAF.
waf_latency_5000_to_10000msintegerNumber of responses with latency between 5,000 and 10,000 milliseconds received for origin requests made by the Fastly WAF.
waf_latency_500_to_1000msintegerNumber of responses with latency between 500 and 1,000 milliseconds received for origin requests made by the Fastly WAF.
waf_latency_50_to_100msintegerNumber of responses with latency between 50 and 100 milliseconds received for origin requests made by the Fastly WAF.
waf_latency_5_to_10msintegerNumber of responses with latency between 5 and 10 milliseconds received for origin requests made by the Fastly WAF.
waf_latency_60000msintegerNumber of responses with latency of 60,000 milliseconds and above received for origin requests made by the Fastly WAF.
waf_resp_body_bytesintegerNumber of body bytes received for origin requests made by the Fastly WAF.
waf_resp_header_bytesintegerNumber of header bytes received for origin requests made by the Fastly WAF.
waf_responsesintegerNumber of responses received for origin requests made by the Fastly WAF.
waf_status_1xxintegerNumber of 1xx "Informational" status codes received for origin requests made by the Fastly WAF.
waf_status_200integerNumber of responses received with status code 200 (Success) received for origin requests made by the Fastly WAF.
waf_status_204integerNumber of responses received with status code 204 (No Content) received for origin requests made by the Fastly WAF.
waf_status_206integerNumber of responses received with status code 206 (Partial Content) received for origin requests made by the Fastly WAF.
waf_status_2xxintegerNumber of 2xx "Success" status codes received for origin requests made by the Fastly WAF.
waf_status_301integerNumber of responses received with status code 301 (Moved Permanently) received for origin requests made by the Fastly WAF.
waf_status_302integerNumber of responses received with status code 302 (Found) received for origin requests made by the Fastly WAF.
waf_status_304integerNumber of responses received with status code 304 (Not Modified) received for origin requests made by the Fastly WAF.
waf_status_3xxintegerNumber of 3xx "Redirection" codes received for origin requests made by the Fastly WAF.
waf_status_400integerNumber of responses received with status code 400 (Bad Request) received for origin requests made by the Fastly WAF.
waf_status_401integerNumber of responses received with status code 401 (Unauthorized) received for origin requests made by the Fastly WAF.
waf_status_403integerNumber of responses received with status code 403 (Forbidden) received for origin requests made by the Fastly WAF.
waf_status_404integerNumber of responses received with status code 404 (Not Found) received for origin requests made by the Fastly WAF.
waf_status_416integerNumber of responses received with status code 416 (Range Not Satisfiable) received for origin requests made by the Fastly WAF.
waf_status_429integerNumber of responses received with status code 429 (Too Many Requests) received for origin requests made by the Fastly WAF.
waf_status_4xxintegerNumber of 4xx "Client Error" codes received for origin requests made by the Fastly WAF.
waf_status_500integerNumber of responses received with status code 500 (Internal Server Error) received for origin requests made by the Fastly WAF.
waf_status_501integerNumber of responses received with status code 501 (Not Implemented) received for origin requests made by the Fastly WAF.
waf_status_502integerNumber of responses received with status code 502 (Bad Gateway) received for origin requests made by the Fastly WAF.
waf_status_503integerNumber of responses received with status code 503 (Service Unavailable) received for origin requests made by the Fastly WAF.
waf_status_504integerNumber of responses received with status code 504 (Gateway Timeout) received for origin requests made by the Fastly WAF.
waf_status_505integerNumber of responses received with status code 505 (HTTP Version Not Supported) received for origin requests made by the Fastly WAF.
waf_status_5xxintegerNumber of 5xx "Server Error" codes received for origin requests made by the Fastly WAF.

Entry data model

Each reporting period is represented by an entry in the Data property of the top level response and provides access to measurement data for that time period, grouped by origin name and optionally by POP. The datacenter property organizes the measurements by Fastly POP, while the aggregated property combines the measurements of all POPs.

aggregatedobjectGroups measurements by backend name.
datacenterobjectGroups measurements by POP, then backend name. See the POPs API for details about POP identifiers.
recordedintegerThe Unix timestamp at which this record's data was generated.

Endpoints

Get real-time origin data from specific time

GET/v1/origins/service_id/ts/start_timestamp

Get real-time origin data for the last 120 seconds

GET/v1/origins/service_id/ts/h

Get a limited number of real-time origin data entries

GET/v1/origins/service_id/ts/h/limit/max_entries