class Aws::Connect::Types::GetMetricDataV2Request
@see docs.aws.amazon.com/goto/WebAPI/connect-2017-08-08/GetMetricDataV2Request AWS API Documentation
@return [Integer]
The maximum number of results to return per page.
@!attribute [rw] max_results
@return [String]
results.
previous response in the next request to retrieve the next set of
The token for the next set of results. Use the value returned in the
@!attribute [rw] next_token
@return [Array<Types::MetricV2>]<br>: docs.aws.amazon.com/connect/latest/adminguide/regions.html#optimization_region<br>[1]: docs.aws.amazon.com/connect/latest/adminguide/historical-metrics-definitions.html<br><br><br><br>contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Count
SUM_RETRY_CALLBACK_ATTEMPTS
Hierarchy
Valid groupings and filters: Routing Profile, Agent, Agent
: Unit: Seconds
SUM_ONLINE_TIME_AGENT
Hierarchy
Valid groupings and filters: Routing Profile, Agent, Agent
: Unit: Seconds
SUM_NON_PRODUCTIVE_TIME_AGENT
Agent, Agent Hierarchy
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Seconds
SUM_INTERACTION_TIME
Agent, Agent Hierarchy
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Seconds
SUM_INTERACTION_AND_HOLD_TIME
Hierarchy
Valid groupings and filters: Routing Profile, Agent, Agent
: Unit: Seconds
SUM_IDLE_TIME_AGENT
Agent, Agent Hierarchy
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Count
SUM_HOLD_TIME
Agent, Agent Hierarchy
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Seconds
SUM_HANDLE_TIME
Agent, Agent Hierarchy
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Seconds
SUM_ERROR_STATUS_TIME_AGENT
Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
Unit: Count
: Valid metric filter key: ‘DISCONNECT_REASON`
SUM_CONTACTS_DISCONNECTED
`LT` (for “Less than”).
604800 (inclusive), in seconds. For `Comparison`, you must enter
Threshold: For `ThresholdValue`, enter any whole number from 1 to
contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Count
SUM_CONTACTS_ABANDONED_IN_X
`LT` (for “Less than”).
604800 (inclusive), in seconds. For `Comparison`, you must enter
Threshold: For `ThresholdValue`, enter any whole number from 1 to
contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Count
SUM_CONTACTS_ANSWERED_IN_X
Agent, Agent Hierarchy
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Seconds
SUM_CONTACT_TIME_AGENT
Agent, Agent Hierarchy
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Seconds
SUM_CONTACT_FLOW_TIME
</note>
this metric.
<note markdown=“1”> The `Negate` key in Metric Level Filters is not applicable for
Agent, Agent Hierarchy
Valid groupings and filters: Queue, Channel, Routing Profile,
`INBOUND` | `OUTBOUND` | `CALLBACK` | `API`
supports the following filter keys as `INITIATION_METHOD`:
Valid metric filter key: `INITIATION_METHOD`. This metric only
: Unit: Seconds
SUM_CONNECTING_TIME_AGENT
Agent, Agent Hierarchy
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Seconds
SUM_AFTER_CONTACT_WORK_TIME
`LT` (for “Less than”).
604800 (inclusive), in seconds. For `Comparison`, you must enter
Threshold: For `ThresholdValue`, enter any whole number from 1 to
Valid groupings and filters: Queue, Channel, Routing Profile
Unit: Percent
: You can include up to 20 SERVICE_LEVEL metrics in a request.
SERVICE_LEVEL
Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
Unit: Percentage
Lens conversational analytics.
: This metric is available only for contacts analyzed by Contact
PERCENT_TALK_TIME_CUSTOMER
Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
Unit: Percentage
Lens conversational analytics.
: This metric is available only for contacts analyzed by Contact
PERCENT_TALK_TIME_AGENT
Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
Unit: Percentage
Lens conversational analytics.
: This metric is available only for contacts analyzed by Contact
PERCENT_TALK_TIME
Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
Unit: Percentage
Lens conversational analytics.
: This metric is available only for contacts analyzed by Contact
PERCENT_NON_TALK_TIME
Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Seconds
MAX_QUEUED_TIME
Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Count
CONTACTS_TRANSFERRED_OUT_FROM_QUEUE
Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Count
CONTACTS_TRANSFERRED_OUT_BY_AGENT
</note>
<note markdown=“1”> Feature is a valid filter but not a valid grouping.
contact/segmentAttributes/connect:Subtype
Agent, Agent Hierarchy, Feature,
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Count
CONTACTS_TRANSFERRED_OUT
`LT` (for “Less than”).
604800 (inclusive), in seconds. For `Comparison`, you must enter
Threshold: For `ThresholdValue` enter any whole number from 1 to
contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Count
CONTACTS_RESOLVED_IN_X
Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Count
CONTACTS_QUEUED
Agent, Agent Hierarchy
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Percent
CONTACTS_TRANSFERRED_OUT_INTERNAL
Agent, Agent Hierarchy
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Count
CONTACTS_TRANSFERRED_OUT_EXTERNAL
Agent, Agent Hierarchy
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Count
CONTACTS_PUT_ON_HOLD
Agent, Agent Hierarchy
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Count
CONTACTS_ON_HOLD_CUSTOMER_DISCONNECT
Agent, Agent Hierarchy
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Count
CONTACTS_ON_HOLD_AGENT_DISCONNECT
Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Count
CONTACTS_HOLD_ABANDONS
</note>
<note markdown=“1”> Feature is a valid filter but not a valid grouping.
contact/segmentAttributes/connect:Subtype
Agent, Agent Hierarchy, Feature,
Valid groupings and filters: Queue, Channel, Routing Profile,
Valid metric filter key: `INITIATION_METHOD`, `DISCONNECT_REASON`
: Unit: Count
CONTACTS_HANDLED
</note>
<note markdown=“1”> Feature is a valid filter but not a valid grouping.
Feature, contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
Valid metric filter key: `INITIATION_METHOD`
: Unit: Count
CONTACTS_CREATED
Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Count
CONTACTS_ABANDONED
Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
Unit: Seconds
Lens conversational analytics.
: This metric is available only for contacts analyzed by Contact
AVG_TALK_TIME_CUSTOMER
Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
Unit: Seconds
Lens conversational analytics.
: This metric is available only for contacts analyzed by Contact
AVG_TALK_TIME_AGENT
Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
Unit: Seconds
Lens conversational analytics.
: This metric is available only for contacts analyzed by Contact
AVG_TALK_TIME
contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Seconds
AVG_RESOLUTION_TIME
</note>
<note markdown=“1”> Feature is a valid filter but not a valid grouping.
Feature, contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Seconds
AVG_QUEUE_ANSWER_TIME
Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
Unit: Seconds
Lens conversational analytics.
: This metric is available only for contacts analyzed by Contact
AVG_NON_TALK_TIME
Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
Unit: Seconds
Lens conversational analytics.
: This metric is available only for contacts analyzed by Contact
AVG_INTERRUPTION_TIME_AGENT
Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
Unit: Count
Lens conversational analytics.
: This metric is available only for contacts analyzed by Contact
AVG_INTERRUPTIONS_AGENT
</note>
<note markdown=“1”> Feature is a valid filter but not a valid grouping.
Feature, contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
Valid metric filter key: `INITIATION_METHOD`
: Unit: Seconds
AVG_INTERACTION_TIME
Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Seconds
AVG_INTERACTION_AND_HOLD_TIME
</note>
<note markdown=“1”> Feature is a valid filter but not a valid grouping.
contact/segmentAttributes/connect:Subtype
Agent, Agent Hierarchy, Feature,
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Count
AVG_HOLDS
Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Seconds
AVG_HOLD_TIME_ALL_CONTACTS
</note>
<note markdown=“1”> Feature is a valid filter but not a valid grouping.
contact/segmentAttributes/connect:Subtype
Agent, Agent Hierarchy, Feature,
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Seconds
AVG_HOLD_TIME
</note>
<note markdown=“1”> Feature is a valid filter but not a valid grouping.
contact/segmentAttributes/connect:Subtype
Agent, Agent Hierarchy, Feature,
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Seconds
AVG_HANDLE_TIME
Agent, Agent Hierarchy, contact/segmentAttributes/connect:Subtype
Valid groupings and filters: Queue, Channel, Routing Profile,
Unit: Seconds
Lens conversational analytics.
: This metric is available only for contacts analyzed by Contact
AVG_GREETING_TIME_AGENT
contact/segmentAttributes/connect:Subtype
Agent, Agent Hierarchy, Feature,
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Seconds
AVG_CONVERSATION_DURATION
</note>
<note markdown=“1”> Feature is a valid filter but not a valid grouping.
contact/segmentAttributes/connect:Subtype
Agent, Agent Hierarchy, Feature,
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Seconds
AVG_CONTACT_DURATION
</note>
this metric.
<note markdown=“1”> The `Negate` key in Metric Level Filters is not applicable for
Agent, Agent Hierarchy
Valid groupings and filters: Queue, Channel, Routing Profile,
`OUTBOUND` | `CALLBACK` | `API`
only supports the following as `INITIATION_METHOD`: `INBOUND` |
Valid metric filter key: `INITIATION_METHOD`. For now, this metric
: Unit: Seconds
AVG_AGENT_CONNECTING_TIME
</note>
<note markdown=“1”> Feature is a valid filter but not a valid grouping.
contact/segmentAttributes/connect:Subtype
Agent, Agent Hierarchy, Feature,
Valid groupings and filters: Queue, Channel, Routing Profile,
Valid metric filter key: `INITIATION_METHOD`
: Unit: Seconds
AVG_AFTER_CONTACT_WORK_TIME
contact/segmentAttributes/connect:Subtype
Agent, Agent Hierarchy, Feature,
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Seconds
AVG_ABANDON_TIME
Agent, Agent Hierarchy
Valid groupings and filters: Queue, Channel, Routing Profile,
Unit: Seconds
[Forecasting, capacity planning, and scheduling] is available.
: This metric is available only in Amazon Web Services Regions where
AGENT_SCHEDULED_TIME
Agent, Agent Hierarchy
Valid groupings and filters: Queue, Channel, Routing Profile,
Unit: Percent
[Forecasting, capacity planning, and scheduling] is available.
: This metric is available only in Amazon Web Services Regions where
AGENT_SCHEDULE_ADHERENCE
Hierarchy
Valid groupings and filters: Routing Profile, Agent, Agent
: Unit: Percentage
AGENT_OCCUPANCY
0:00:00 GMT.
Data for this metric is available starting from October 1, 2023
Agent, Agent Hierarchy
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Count
AGENT_NON_RESPONSE_WITHOUT_CUSTOMER_ABANDONS
Agent, Agent Hierarchy
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Count
AGENT_NON_RESPONSE
Agent, Agent Hierarchy
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Seconds
AGENT_NON_ADHERENT_TIME
Agent, Agent Hierarchy
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Percent
AGENT_ANSWER_RATE
Agent, Agent Hierarchy
Valid groupings and filters: Queue, Channel, Routing Profile,
Unit: Seconds
[Forecasting, capacity planning, and scheduling] is available.
: This metric is available only in Amazon Web Services Regions where
AGENT_ADHERENT_TIME
contact/segmentAttributes/connect:Subtype
Agent, Agent Hierarchy, Feature,
Valid groupings and filters: Queue, Channel, Routing Profile,
: Unit: Percent<br><br>ABANDONMENT_RATE<br><br>definitions] in the *Amazon Connect Administrator’s Guide*.
a description of each metric, see [Historical metrics
for each metric. The following historical metrics are available. For
The metrics to retrieve. Specify the name, groupings, and filters
@!attribute [rw] metrics
@return [Array<String>]
‘contact/segmentAttributes/connect:Subtype`
`AGENT_HIERARCHY_LEVEL_FOUR` | `AGENT_HIERARCHY_LEVEL_FIVE`,
`AGENT_HIERARCHY_LEVEL_TWO` | `AGENT_HIERARCHY_LEVEL_THREE` |
`CHANNEL` | `AGENT_HIERARCHY_LEVEL_ONE` |
Valid grouping keys: `QUEUE` | `ROUTING_PROFILE` | `AGENT` |
If no grouping is specified, a summary of all metrics is returned.
queue. They are not aggregated for all queues.
by queue. The values that are returned apply to the metrics for each
when results are grouped by queue, the metrics returned are grouped
The grouping applied to the metrics that are returned. For example,
@!attribute [rw] groupings
@return [Array<Types::FilterV2>]<br>: docs.aws.amazon.com/connect/latest/adminguide/create-historical-metrics-report.html<br><br><br><br>for the `contact/segmentAttributes/connect:Subtype filter` key.
`connect:WebRTC` are valid `filterValue` examples (not exhaustive)
`connect:Chat`, `connect:SMS`, `connect:Telephony`, and
analyzed by Contact Lens conversational analytics.
the `FEATURE` filter key. It is available only to contacts
`contact_lens_conversational_analytics` is a valid filterValue for
total of 100 filter values, along with 3 channel filters.
filter by 50 queues, 35 agents, and 15 routing profiles for a
of 100 filter values. For example, a GetMetricDataV2 request can
for the CHANNEL filter key. They do not count towards limitation
a single request. VOICE, CHAT, and TASK are valid `filterValue`
* **Filter values**: A maximum of 100 filter values are supported in
`FEATURE` | `contact/segmentAttributes/connect:Subtype`
`AGENT_HIERARCHY_LEVEL_FOUR` | `AGENT_HIERARCHY_LEVEL_FIVE` |
`AGENT_HIERARCHY_LEVEL_TWO` | `AGENT_HIERARCHY_LEVEL_THREE` |
`AGENT` | `CHANNEL` | `AGENT_HIERARCHY_LEVEL_ONE` |
single request. Valid filter keys: `QUEUE` | `ROUTING_PROFILE` |
* **Filter keys**: A maximum of 5 filter keys are supported in a
Note the following limits:<br><br>report] in the *Amazon Connect Administrator’s Guide*.
To filter by phone number, see [Create a historical metrics
agents, or user hierarchy groups.
At least one filter must be passed from queues, routing profiles,
* Feature
* User hierarchy groups
* Channels
* Agents
* Routing profiles
* Queues
following resources:
The filters to apply to returned metrics. You can filter on the
@!attribute [rw] filters
@return [Types::IntervalDetails]
* ‘TimeZone`: The timezone applied to requested metrics.
be less than 35 days.
* `TOTAL`: The difference between `StartTime` and `EndTime` must
less than 35 days.
* `WEEK`: The difference between `StartTime` and `EndTime` must be
less than 35 days.
* `DAY`: The difference between `StartTime` and `EndTime` must be
less than 3 days.
* `HOUR`: The difference between `StartTime` and `EndTime` must be
must be less than 3 days.
* `THIRTY_MIN`: The difference between `StartTime` and `EndTime`
must be less than 3 days.
* `FIFTEEN_MIN`: The difference between `StartTime` and `EndTime`
`EndTime` based on which `IntervalPeriod` is requested.
The following list describes restrictions on `StartTime` and
results based on the `TOTAL` interval period.
the THIRTY_MIN period. By default Amazon Connect aggregates
returns 48 results in the response. Each result is aggregated by
`StartTime` and `EndTime` differs by 1 day, then Amazon Connect
For example, if `IntervalPeriod` is selected `THIRTY_MIN`,
`THIRTY_MIN` | `HOUR` | `DAY` | `WEEK` | `TOTAL`.
metrics. Valid `IntervalPeriod` values are: `FIFTEEN_MIN` |
* `IntervalPeriod`: An aggregated grouping applied to request
The interval period and timezone to apply to returned metrics.
@!attribute [rw] interval
@return [Time]
than the current timestamp.
time must be later than the start time timestamp. It cannot be later
reporting interval for the retrieval of historical metrics data. The
The timestamp, in UNIX Epoch time format, at which to end the
@!attribute [rw] end_time
@return [Time]
available for 3 months.
between start and end time is 35 days. Historical metrics are
depends on the `IntervalPeriod` selected. By default the time range
time must be before the end time timestamp. The start and end time
reporting interval for the retrieval of historical metrics data. The
The timestamp, in UNIX Epoch time format, at which to start the
@!attribute [rw] start_time
@return [String]
`instanceId` an Amazon Connect instance.
The Amazon Resource Name (ARN) of the resource. This includes the
@!attribute [rw] resource_arn