Total Requests

TraceView instrumentation can count the total number of requests to your app. The Total Requests API exposes this data.

Endpoints

Series

GET /api-v2/total_requests/<app-name>/series

Return a timeseries of the application’s total requests. This is the total number of requests to your application within each second. Each point returned is an array of (timestamp, total_requests).

Value Description
fields Comma-separated string listing the fieldnames
items A list of lists – the timeseries data
timestamp Seconds since the epoch of this point
total_requests The total requests to your application at this point

Each series will have ~100 data points in it (with appropriately varying step size), depending on the time_window requested.

Example output:

{
    "data": {
        "fields": "timestamp,total_requests",
        'items': [
            [ 1433360130, 262 ],
            [ 1433360160, 224 ],
            [ 1433360190, 201 ],
            [ 1433360220, 222 ]
        ]
    },
    "response": "ok"
}

Summary

GET /api-v2/total_requests/<app-name>/summary

Returns a summary of the total requests. The return value contains the following entries:

Value Description
total_requests The total number of requests over the time period
reqs_per_time_period The average total requests per time period (second, minute, hour)

* Requests per time period is the total number of requests divided by the most recent hour, day, or week, depending on the value of time_window (hour, day, and week, respectively). Please note that if you have recently updated your instrumentation to support this new feature, the total requests per time period will be calculated over the time period for which you have total request data.

Example output:

{
    "data": {
        "reqs_per_time_period": "0.27/sec",
        "total_requests": 980
    },
    "response": "ok"
}

Filters

All endpoints in this section can take the following optional query parameters:

Parameter Options Description
time_window hour, day, or week How far back to fetch data. Defaults to hour
time_end ISO-8601 date/time or ms since epoch Shifts the time window back so it ends at that time

Table Of Contents

Related Topics