Delivery Service Statistics

/api/1.2/deliveryservice_stats

GET /api/1.2/deliveryservice_stats.json

Retrieves statistics on the delivery services. See also Using Traffic Ops - Delivery Service.

Authentication Required: Yes

Role(s) Required: None

Request Query Parameters

Name Required Description
deliveryServiceName yes The delivery service with the desired stats
metricType yes The metric type (valid metric types: ‘kbps’, ‘out_bytes’, ‘status_4xx’, ‘status_5xx’, tps_total’, ‘tps_2xx’,’tps_3xx’, ‘tps_4xx’, ‘tps_5xx’)
startDate yes The begin date (Formatted as ISO8601, for example: ‘2015-08-11T12:30:00-06:00’)
endDate yes The end date (Formatted as ISO8601, for example: ‘2015-08-12T12:30:00-06:00’)

Response Properties

Parameter Type Description
source string The source of the data
summary hash Summary data
>totalBytes float  
>count int  
>min float  
>max float  
>fifthPercentile float  
>ninetyEighthPercentile float  
>ninetyFifthPercentile float  
>average float  
>totalTransactions int  
series hash Series data
>count int  
>columns array  
>name string  
>values array  
>>time string  
>>value float  

Response Example

{
    "response": {
        "source": "TrafficStats",
        "summary": {
            "average": 1081172.785,
            "count": 28,
            "fifthPercentile": 888827.26,
            "max": 1326680.31,
            "min": 888827.26,
            "ninetyEighthPercentile": 1324785.47,
            "ninetyFifthPercentile": 1324785.47,
            "totalBytes": 37841047.475,
            "totalTransactions": 1020202030101
        },
        "series": {
            "columns": [
                "time",
                ""
            ],
            "count": 60,
            "name": "kbps",
            "tags": {
                "cachegroup": "total"
            },
            "values": [
                [
                    "2015-08-11T11:36:00Z",
                    888827.26
                ],
                [
                    "2015-08-11T11:37:00Z",
                    980336.563333333
                ],
                [
                    "2015-08-11T11:38:00Z",
                    952111.975
                ],
                [
                    "2015-08-11T11:39:00Z",
                    null
                ],
                [
                    "2015-08-11T11:43:00Z",
                    null
                ],
                [
                    "2015-08-11T11:44:00Z",
                    934682.943333333
                ],
                [
                    "2015-08-11T11:45:00Z",
                    1251121.28
                ],
                [
                    "2015-08-11T11:46:00Z",
                    1111012.99
                ]
            ]
        }
    }
}