.. 
.. Copyright 2015 Comcast Cable Communications Management, LLC
.. 
.. Licensed under the Apache License, Version 2.0 (the "License");
.. you may not use this file except in compliance with the License.
.. You may obtain a copy of the License at
.. 
..     http://www.apache.org/licenses/LICENSE-2.0
.. 
.. Unless required by applicable law or agreed to in writing, software
.. distributed under the License is distributed on an "AS IS" BASIS,
.. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
.. See the License for the specific language governing permissions and
.. limitations under the License.
.. 


.. _to-api-v12-ds-stats:

Delivery Service Statistics
===========================

.. _to-api-v12-ds-stats-route:

/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 <http://traffic-control-cdn.net/docs/latest/admin/traffic_ops_using.html#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
                                ]
                            ]
                        }
                    }
                }

|