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