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
$SAVEDor$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_MANAGEDRequired: Yes
- Unit
-
The display unit for the metric's data.
Type: String
Valid Values:
INTEGER | DOUBLE | PERCENT | SECONDSRequired: 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_BUILDERRequired: 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 | NEUTRALRequired: 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 | SAVEDRequired: 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: