getMTTAStats

A GET request that returns the Mean Time To Acknowledge (MTTA) Situations in the specified time range.

The time to acknowledge (TTA) for a Situation is the duration from the first event's inclusion in the Situation to the time when a moderator assigns a Situation to a user in Moogsoft Enterprise.

Back to Stats API.

Request arguments

Endpoint getMTTAStats 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.
`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.

Response

Endpoint getMTTAStats 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.

Examples

The following examples demonstrate typical use of endpoint getMTTAStats:

Request example

A cURL command to return the MTTA for Moogsoft Enterprise over a 24 hour time range from 11.09am on Sunday 17th December until 11.09am on Monday 18th December 2017:

curl -G -u graze:graze -k -v "https://localhost/graze/v1/getMTTAStats" --data-urlencode 'from=1513508950' --data-urlencode 'to=1513595370'

Response example

A successful response returns the MTTA in seconds for each hour:

[{
        "datapoints": [
                [312.0, 1513657700000],
                [209.0, 1513661300000],
                [101.0, 1513664900000],
                [114.0, 1513668500000],
                [203.0, 1513672100000],
                [120.0, 1513675700000],
                [201.0, 1513679300000],
                [90.0, 1513682900000],
                [100.0, 1513686500000]
        ],
        "target": "Mean Time to Acknowledge (MTTA)"
}]

In this section: