get_time_series_service_statistics

XRay.Client.get_time_series_service_statistics(**kwargs)

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

See also: AWS API Documentation

Request Syntax

response = client.get_time_series_service_statistics(
    StartTime=datetime(2015, 1, 1),
    EndTime=datetime(2015, 1, 1),
    GroupName='string',
    GroupARN='string',
    EntitySelectorExpression='string',
    Period=123,
    ForecastStatistics=True|False,
    NextToken='string'
)
Parameters
  • StartTime (datetime) --

    [REQUIRED]

    The start of the time frame for which to aggregate statistics.

  • EndTime (datetime) --

    [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.
Return type

dict

Returns

Response Syntax

{
    'TimeSeriesServiceStatistics': [
        {
            'Timestamp': datetime(2015, 1, 1),
            'EdgeSummaryStatistics': {
                'OkCount': 123,
                'ErrorStatistics': {
                    'ThrottleCount': 123,
                    'OtherCount': 123,
                    'TotalCount': 123
                },
                'FaultStatistics': {
                    'OtherCount': 123,
                    'TotalCount': 123
                },
                'TotalCount': 123,
                'TotalResponseTime': 123.0
            },
            'ServiceSummaryStatistics': {
                'OkCount': 123,
                'ErrorStatistics': {
                    'ThrottleCount': 123,
                    'OtherCount': 123,
                    'TotalCount': 123
                },
                'FaultStatistics': {
                    'OtherCount': 123,
                    'TotalCount': 123
                },
                'TotalCount': 123,
                'TotalResponseTime': 123.0
            },
            'ServiceForecastStatistics': {
                'FaultCountHigh': 123,
                'FaultCountLow': 123
            },
            'ResponseTimeHistogram': [
                {
                    'Value': 123.0,
                    'Count': 123
                },
            ]
        },
    ],
    'ContainsOldGroupVersions': True|False,
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • TimeSeriesServiceStatistics (list) --

      The collection of statistics.

      • (dict) --

        A list of TimeSeriesStatistic structures.

        • Timestamp (datetime) --

          Timestamp of the window for which statistics are aggregated.

        • EdgeSummaryStatistics (dict) --

          Response statistics for an edge.

          • OkCount (integer) --

            The number of requests that completed with a 2xx Success status code.

          • ErrorStatistics (dict) --

            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 (dict) --

            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 (float) --

            The aggregate response time of completed requests.

        • ServiceSummaryStatistics (dict) --

          Response statistics for a service.

          • OkCount (integer) --

            The number of requests that completed with a 2xx Success status code.

          • ErrorStatistics (dict) --

            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 (dict) --

            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 (float) --

            The aggregate response time of completed requests.

        • ServiceForecastStatistics (dict) --

          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 (list) --

          The response time histogram for the selected entities.

          • (dict) --

            An entry in a histogram for a statistic. A histogram maps the range of observed values on the X axis, and the prevalence of each value on the Y axis.

            • Value (float) --

              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.

Exceptions

  • XRay.Client.exceptions.InvalidRequestException
  • XRay.Client.exceptions.ThrottledException