View a markdown version of this page

MetricDefinition - Amazon Connect Customer

MetricDefinition

Contains the full definition of a metric, including its calculation, unit, status, and trend indicator.

Contents

Arn

The Amazon Resource Name (ARN) of the metric. May be qualified with $SAVED or $LATEST.

Type: String

Required: Yes

Category

The category of the metric.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 100.

Required: Yes

Filters

The filters applied to the metric.

Type: Array of AvailableFilter objects

Required: Yes

Groupings

The groupings available for this metric.

Type: Array of strings

Required: Yes

Id

The identifier of the metric.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 150.

Required: Yes

Name

The name of the metric.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 128.

Required: Yes

SupportsCustomCalculation

Specifies whether the metric can be used as a component of custom metrics.

Type: Boolean

Required: Yes

SupportsPreaggregateCalculation

Specifies whether the metric can be used inside aggregating statistical functions (SUM, AVG, etc.) in custom metric calculations.

Type: Boolean

Required: Yes

Type

The type of the metric. Valid values: AWS_MANAGED | CUSTOMER_MANAGED.

Type: String

Valid Values: AWS_MANAGED | CUSTOMER_MANAGED

Required: Yes

Unit

The display unit for the metric's data.

Type: String

Valid Values: INTEGER | DOUBLE | PERCENT | SECONDS

Required: Yes

CreatedTime

The timestamp of when the metric was created.

Type: Timestamp

Required: No

CreatedUser

The user that created the metric. The creator for metrics created through the CreateMetric API will be Amazon Connect API.

Type: CreatedByInfo object

Note: This object is a Union. Only one member of this object can be specified or returned.

Required: No

CreationMethod

The method used to create the metric. Valid values: SERVICE_LEVEL_BUILDER (created with the guided service-level experience) | METRIC_BUILDER (created with the free-form metric builder).

Type: String

Valid Values: SERVICE_LEVEL_BUILDER | METRIC_BUILDER

Required: No

DefaultStat

The default stat aggregation for the metric.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 50.

Required: No

Description

The description of the metric.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 500.

Required: No

EffectiveTime

The earliest time that can be queried for this metric.

Type: Timestamp

Required: No

LastModifiedRegion

The region where the metric was last modified.

Type: String

Pattern: [a-z]{2}(-[a-z]+){1,2}(-[0-9])?

Required: No

LastModifiedTime

The timestamp of when the metric was last modified.

Type: Timestamp

Required: No

LastModifiedUser

The user that last modified the metric. For modifications made through the API, this will be Amazon Connect API.

Type: CreatedByInfo object

Note: This object is a Union. Only one member of this object can be specified or returned.

Required: No

MetricCalculation

The calculation definition for the metric.

Type: MetricCalculation object

Required: No

PositiveTrendIndicator

How an increase in the metric value should be interpreted. Valid values: POSITIVE, NEUTRAL, NEGATIVE.

Type: String

Valid Values: POSITIVE | NEGATIVE | NEUTRAL

Required: No

PrimaryEventSource

The primary event source for the metric data.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 100.

Required: No

PrimaryEventSourceEffectiveTimestampType

The timestamp type that determines where the metric appears on a time series.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 100.

Required: No

RefreshRate

The minimum interval, in seconds, between data refreshes for this metric.

Type: Long

Required: No

Status

The publish status of the metric. Valid values: PUBLISHED | SAVED.

Type: String

Valid Values: PUBLISHED | SAVED

Required: No

SupportedStats

The stat aggregations available for this metric.

Type: Array of strings

Required: No

Tags

The tags used to organize, track, or control access for this resource. For example, { "Tags": {"key1":"value1", "key2":"value2"} }.

Type: String to string map

Map Entries: Maximum number of 50 items.

Key Length Constraints: Minimum length of 1. Maximum length of 128.

Key Pattern: ^(?!aws:)[\p{L}\p{Z}\p{N}_.:/=+\-@]*$

Value Length Constraints: Maximum length of 256.

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: