getMTTAPerTeamStats

A GET request that returns the mean time to acknowledge (MTTA) a Situation per team in the specified time range.

Request arguments

Endpoint getMTTAPerTeamStats takes the following request arguments.

Name	Type	Description
`auth_token`	String	A valid `auth_token` returned from the `authenticate` request. Alternatively, basic authenticate headers can be used in place of this parameter. See the authenticate endpoint for more information and usage examples.
`teams`	Array	An array of team IDs. This is required. If no teams are provided, the endpoint does not return any data.
`from`	Number	Start of the reporting time range. This is a Unix epoch timestamp in seconds.
`to`	Number	End of the reporting time range. This is a Unix epoch timestamp in seconds. If this timestamp is within 10 seconds of the current system time, the last datapoint returned is the current state datapoint.
`aggregation`	String	Set to: `accumulate`: Gradually adds data points together over time. `none`: No aggregation of data points.

Response

Endpoint getMTTAPerTeamStats returns the following response:

Type	Description
HTTP Code	HTTP status or error code indicating request success or failure. See HTTP status code definitions for more information.

Successful requests return a JSON object containing the following:

Name	Type	Description
`target`	String	"Mean Time to Acknowledge (MTTA)"
`datapoints`	Number Array	An array of data points. Each data point is an array in the format [data point, timestamp]: Data point:MTTA (seconds) for that bucket. Timestamp: Calculation time (Unix epoch timestamp in milliseconds). Less than 1 week: Returns the MTTA each hour in the time period. 1 week to 1 month: Returns the MTTA each day in the time period. 1 month to 1 year: Returns the MTTA each week in the time period. More than 1 year: Returns the MTTA each month in the time period.

Name

Type

Description

target

String

"Mean Time to Acknowledge (MTTA)"

datapoints

Number Array

An array of data points. Each data point is an array in the format [data point, timestamp]:

Data point:MTTA (seconds) for that bucket.
Timestamp: Calculation time (Unix epoch timestamp in milliseconds).

Examples

The following examples demonstrate typical use of endpoint getMTTAPerTeamStats:

Request example

A cURL command request to find out the MTTA for the Cloud DevOps team over a year from 13.14pm on Monday 31st July 2017 until 13.14.pm on Tuesday 31st July 2018:

curl -G -u graze:graze -k -v "https://localhost/graze/v1/getMTTAPerTeamStats" --data-urlencode 'from=1501506840' --data-urlencode 'to=1533042840' --data-urlencode 'teams=[1]'  --data-urlencode 'aggregation=none'

Response example

A successful response shows the MTTA for the year was 3.32 minutes:

[{
 "datapoints": [
        [213.0, 1532956486000]
 ],
 "target": "Mean Time to Acknowledge (MTTA)"
}]

In this section: