---
title: "POST /TimeSeriesServiceStatistics"
method: POST
path: "/TimeSeriesServiceStatistics"
---

# POST /TimeSeriesServiceStatistics

`POST /TimeSeriesServiceStatistics`

Get an aggregation of service statistics defined by a specific time range.

## Query parameters

- `NextToken` string

## Request body

- object
  - `StartTime` string, date-time, required — The start of the time frame for which to aggregate statistics.
  - `EndTime` string, date-time, required — The end of the time frame for which to aggregate statistics.
  - `GroupName` string — The case-sensitive name of the group for which to pull statistics from.
  - `GroupARN` string — The Amazon Resource Name (ARN) of the group for which to pull statistics from.
  - `EntitySelectorExpression` string — A filter expression defining entities that will be aggregated for statistics. Supports ID, service, and edge functions. If no selector expression is specified, edge statistics are returned.
  - `Period` integer — Aggregation period in seconds.
  - `ForecastStatistics` boolean — The forecasted high and low fault count values. Forecast enabled requests require the EntitySelectorExpression ID be provided.
  - `NextToken` string — Pagination token.

## Response `200`

Success

- GetTimeSeriesServiceStatisticsResult
  - `TimeSeriesServiceStatistics` TimeSeriesServiceStatistics[] — The collection of statistics.
    - `Timestamp` string, date-time — Timestamp of the window for which statistics are aggregated.
    - `EdgeSummaryStatistics` EdgeStatistics — Response statistics for an edge.
      - `OkCount` integer — The number of requests that completed with a 2xx Success status code.
      - `ErrorStatistics` object — Information about requests that failed with a 4xx Client Error status code.
        - `ThrottleCount` integer — The number of requests that failed with a 419 throttling status code.
        - `OtherCount` integer — The number of requests that failed with untracked 4xx Client Error status codes.
        - `TotalCount` integer — The total number of requests that failed with a 4xx Client Error status code.
      - `FaultStatistics` object — Information about requests that failed with a 5xx Server Error status code.
        - `OtherCount` integer — The number of requests that failed with untracked 5xx Server Error status codes.
        - `TotalCount` integer — The total number of requests that failed with a 5xx Server Error status code.
      - `TotalCount` integer — The total number of completed requests.
      - `TotalResponseTime` number, double — The aggregate response time of completed requests.
    - `ServiceSummaryStatistics` ServiceStatistics — Response statistics for a service.
      - `OkCount` integer — The number of requests that completed with a 2xx Success status code.
      - `ErrorStatistics` object — Information about requests that failed with a 4xx Client Error status code.
        - `ThrottleCount` integer — The number of requests that failed with a 419 throttling status code.
        - `OtherCount` integer — The number of requests that failed with untracked 4xx Client Error status codes.
        - `TotalCount` integer — The total number of requests that failed with a 4xx Client Error status code.
      - `FaultStatistics` object — Information about requests that failed with a 5xx Server Error status code.
        - `OtherCount` integer — The number of requests that failed with untracked 5xx Server Error status codes.
        - `TotalCount` integer — The total number of requests that failed with a 5xx Server Error status code.
      - `TotalCount` integer — The total number of completed requests.
      - `TotalResponseTime` number, double — The aggregate response time of completed requests.
    - `ServiceForecastStatistics` object — The forecasted high and low fault count values.
      - `FaultCountHigh` integer — The upper limit of fault counts for a service.
      - `FaultCountLow` integer — The lower limit of fault counts for a service.
    - `ResponseTimeHistogram` HistogramEntry[] — The response time histogram for the selected entities.
      - `Value` number, double — The value of the entry.
      - `Count` integer — The prevalence of the entry.
  - `ContainsOldGroupVersions` boolean — A flag indicating whether or not a group's filter expression has been consistent, or if a returned aggregation might show statistics from an older version of the group's filter expression.
  - `NextToken` string — Pagination token.

## Other responses

- `480` — InvalidRequestException
- `481` — ThrottledException

---

[API](https://skmtc.net/aws/apis/xray.md) · [All operations](https://skmtc.net/aws/apis/xray/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/xray/versions/4970909a360e/schema)