Stats

class aws_cdk.aws_cloudwatch.Stats

Bases: object

Factory functions for standard statistics strings.

ExampleMetadata:

infused

Example:

# dashboard: cloudwatch.Dashboard
# execution_count_metric: cloudwatch.Metric
# error_count_metric: cloudwatch.Metric


dashboard.add_widgets(cloudwatch.GraphWidget(
    title="Executions vs error rate",

    left=[execution_count_metric],

    right=[error_count_metric.with(
        statistic=cloudwatch.Stats.AVERAGE,
        label="Error rate",
        color=cloudwatch.Color.GREEN
    )]
))

Attributes

AVERAGE = 'Average'
IQM = 'IQM'
MAXIMUM = 'Maximum'
MINIMUM = 'Minimum'
SAMPLE_COUNT = 'SampleCount'
SUM = 'Sum'

Static Methods

classmethod p(percentile)

A shorter alias for percentile().

Parameters:

percentile (Union[int, float]) –

Return type:

str

classmethod percentile(percentile)

Percentile indicates the relative standing of a value in a dataset.

Percentiles help you get a better understanding of the distribution of your metric data.

For example, p(90) is the 90th percentile and means that 90% of the data within the period is lower than this value and 10% of the data is higher than this value.

Parameters:

percentile (Union[int, float]) –

Return type:

str

classmethod percentile_rank(v1, v2=None)

Percentile rank (PR) is the percentage of values that meet a fixed threshold.

  • If two numbers are given, they define the lower and upper bounds in absolute values, respectively.

  • If one number is given, it defines the upper bound (the lower bound is assumed to be 0).

For example, percentileRank(300) returns the percentage of data points that have a value of 300 or less. percentileRank(100, 2000) returns the percentage of data points that have a value between 100 and 2000.

Parameters:
  • v1 (Union[int, float]) –

  • v2 (Union[int, float, None]) –

Return type:

str

classmethod pr(v1, v2=None)

Shorter alias for percentileRank().

Parameters:
  • v1 (Union[int, float]) –

  • v2 (Union[int, float, None]) –

Return type:

str

classmethod tc(p1, p2=None)

Shorter alias for trimmedCount().

Parameters:
  • p1 (Union[int, float]) –

  • p2 (Union[int, float, None]) –

Return type:

str

classmethod tm(p1, p2=None)

A shorter alias for trimmedMean().

Parameters:
  • p1 (Union[int, float]) –

  • p2 (Union[int, float, None]) –

Return type:

str

classmethod trimmed_count(p1, p2=None)

Trimmed count (TC) is the number of data points in the chosen range for a trimmed mean statistic.

  • If two numbers are given, they define the lower and upper bounds in percentages, respectively.

  • If one number is given, it defines the upper bound (the lower bound is assumed to be 0).

For example, tc(90) returns the number of data points not including any data points that fall in the highest 10% of the values. tc(10, 90) returns the number of data points not including any data points that fall in the lowest 10% of the values and the highest 90% of the values.

Parameters:
  • p1 (Union[int, float]) –

  • p2 (Union[int, float, None]) –

Return type:

str

classmethod trimmed_mean(p1, p2=None)

Trimmed mean (TM) is the mean of all values that are between two specified boundaries.

Values outside of the boundaries are ignored when the mean is calculated. You define the boundaries as one or two numbers between 0 and 100, up to 10 decimal places. The numbers are percentages.

  • If two numbers are given, they define the lower and upper bounds in percentages, respectively.

  • If one number is given, it defines the upper bound (the lower bound is assumed to be 0).

For example, tm(90) calculates the average after removing the 10% of data points with the highest values; tm(10, 90) calculates the average after removing the 10% with the lowest and 10% with the highest values.

Parameters:
  • p1 (Union[int, float]) –

  • p2 (Union[int, float, None]) –

Return type:

str

classmethod trimmed_sum(p1, p2=None)

Trimmed sum (TS) is the sum of the values of data points in a chosen range for a trimmed mean statistic.

It is equivalent to (Trimmed Mean) * (Trimmed count).

  • If two numbers are given, they define the lower and upper bounds in percentages, respectively.

  • If one number is given, it defines the upper bound (the lower bound is assumed to be 0).

For example, ts(90) returns the sum of the data points not including any data points that fall in the highest 10% of the values. ts(10, 90) returns the sum of the data points not including any data points that fall in the lowest 10% of the values and the highest 90% of the values.

Parameters:
  • p1 (Union[int, float]) –

  • p2 (Union[int, float, None]) –

Return type:

str

classmethod ts(p1, p2=None)

Shorter alias for trimmedSum().

Parameters:
  • p1 (Union[int, float]) –

  • p2 (Union[int, float, None]) –

Return type:

str

classmethod winsorized_mean(p1, p2=None)

Winsorized mean (WM) is similar to trimmed mean.

However, with winsorized mean, the values that are outside the boundary are not ignored, but instead are considered to be equal to the value at the edge of the appropriate boundary. After this normalization, the average is calculated. You define the boundaries as one or two numbers between 0 and 100, up to 10 decimal places.

  • If two numbers are given, they define the lower and upper bounds in percentages, respectively.

  • If one number is given, it defines the upper bound (the lower bound is assumed to be 0).

For example, tm(90) calculates the average after removing the 10% of data points with the highest values; tm(10, 90) calculates the average after removing the 10% with the lowest and 10% with the highest values.

For example, wm(90) calculates the average while treating the 10% of the highest values to be equal to the value at the 90th percentile. wm(10, 90) calculates the average while treaing the bottom 10% and the top 10% of values to be equal to the boundary values.

Parameters:
  • p1 (Union[int, float]) –

  • p2 (Union[int, float, None]) –

Return type:

str

classmethod wm(p1, p2=None)

A shorter alias for winsorizedMean().

Parameters:
  • p1 (Union[int, float]) –

  • p2 (Union[int, float, None]) –

Return type:

str