# HistoricalMetric
<a name="API_HistoricalMetric"></a>

Contains information about a historical metric. 

## Contents
<a name="API_HistoricalMetric_Contents"></a>

 ** Name **   <a name="connect-Type-HistoricalMetric-Name"></a>
The name of the metric. Following is a list of each supported metric mapped to the UI name, linked to a detailed description in the *Amazon Connect Administrator Guide*.     
ABANDON\$1TIME  
Unit: SECONDS  
Statistic: AVG  
UI name: [Average queue abandon time](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html#average-queue-abandon-time)   
AFTER\$1CONTACT\$1WORK\$1TIME  
Unit: SECONDS  
Statistic: AVG  
UI name: [After contact work time](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html#after-contact-work-time)   
API\$1CONTACTS\$1HANDLED  
Unit: COUNT  
Statistic: SUM  
UI name: [API contacts handled](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html#api-contacts-handled)   
AVG\$1HOLD\$1TIME  
Unit: SECONDS  
Statistic: AVG  
UI name: [Average customer hold time](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html#average-customer-hold-time)   
CALLBACK\$1CONTACTS\$1HANDLED  
Unit: COUNT  
Statistic: SUM  
UI name: [Callback contacts handled](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html#callback-contacts-handled)   
CONTACTS\$1ABANDONED  
Unit: COUNT  
Statistic: SUM  
UI name: [Contacts abandoned](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html#contacts-abandoned)   
CONTACTS\$1AGENT\$1HUNG\$1UP\$1FIRST  
Unit: COUNT  
Statistic: SUM  
UI name: [Contacts agent hung up first](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html#contacts-agent-hung-up-first)   
CONTACTS\$1CONSULTED  
Unit: COUNT  
Statistic: SUM  
UI name: [Contacts consulted](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html#contacts-consulted)   
CONTACTS\$1HANDLED  
Unit: COUNT  
Statistic: SUM  
UI name: [Contacts handled](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html#contacts-handled)   
CONTACTS\$1HANDLED\$1INCOMING  
Unit: COUNT  
Statistic: SUM  
UI name: [Contacts handled incoming](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html#contacts-handled-incoming)   
CONTACTS\$1HANDLED\$1OUTBOUND  
Unit: COUNT  
Statistic: SUM  
UI name: [Contacts handled outbound](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html#contacts-handled-outbound)   
CONTACTS\$1HOLD\$1ABANDONS  
Unit: COUNT  
Statistic: SUM  
UI name: [Contacts hold disconnect](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html#contacts-hold-disconnect)   
CONTACTS\$1MISSED  
Unit: COUNT  
Statistic: SUM  
UI name: [AGENT\$1NON\$1RESPONSE](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html#agent-non-response)   
CONTACTS\$1QUEUED  
Unit: COUNT  
Statistic: SUM  
UI name: [Contacts queued](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html#contacts-queued)   
CONTACTS\$1TRANSFERRED\$1IN  
Unit: COUNT  
Statistic: SUM  
UI name: [Contacts transferred in](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html#contacts-transferred-in)   
CONTACTS\$1TRANSFERRED\$1IN\$1FROM\$1QUEUE  
Unit: COUNT  
Statistic: SUM  
UI name: [Contacts transferred out queue](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html#contacts-transferred-out-queue)   
CONTACTS\$1TRANSFERRED\$1OUT  
Unit: COUNT  
Statistic: SUM  
UI name: [Contacts transferred out](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html#contacts-transferred-out)   
CONTACTS\$1TRANSFERRED\$1OUT\$1FROM\$1QUEUE  
Unit: COUNT  
Statistic: SUM  
UI name: [Contacts transferred out queue](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html#contacts-transferred-out-queue)   
HANDLE\$1TIME  
Unit: SECONDS  
Statistic: AVG  
UI name: [Average handle time](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html#average-handle-time)   
INTERACTION\$1AND\$1HOLD\$1TIME  
Unit: SECONDS  
Statistic: AVG  
UI name: [Average agent interaction and customer hold time](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html#average-agent-interaction-and-customer-hold-time)   
INTERACTION\$1TIME  
Unit: SECONDS  
Statistic: AVG  
UI name: [Average agent interaction time](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html#aaverage-agent-interaction-time)   
OCCUPANCY  
Unit: PERCENT  
Statistic: AVG  
UI name: [Occupancy](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html#occupancy)   
QUEUE\$1ANSWER\$1TIME  
Unit: SECONDS  
Statistic: AVG  
UI name: [Average queue answer time](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html##average-queue-answer-time)   
QUEUED\$1TIME  
Unit: SECONDS  
Statistic: MAX  
UI name: [Minimum flow time](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html#minimum-flow-time)   
SERVICE\$1LEVEL  
You can include up to 20 SERVICE\$1LEVEL metrics in a request.  
Unit: PERCENT  
Statistic: AVG  
Threshold: For `ThresholdValue`, enter any whole number from 1 to 604800 (inclusive), in seconds. For `Comparison`, you must enter `LT` (for "Less than").   
UI name: [Service level X](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html#service-level) 
Type: String  
Valid Values: `CONTACTS_QUEUED | CONTACTS_HANDLED | CONTACTS_ABANDONED | CONTACTS_CONSULTED | CONTACTS_AGENT_HUNG_UP_FIRST | CONTACTS_HANDLED_INCOMING | CONTACTS_HANDLED_OUTBOUND | CONTACTS_HOLD_ABANDONS | CONTACTS_TRANSFERRED_IN | CONTACTS_TRANSFERRED_OUT | CONTACTS_TRANSFERRED_IN_FROM_QUEUE | CONTACTS_TRANSFERRED_OUT_FROM_QUEUE | CONTACTS_MISSED | CALLBACK_CONTACTS_HANDLED | API_CONTACTS_HANDLED | OCCUPANCY | HANDLE_TIME | AFTER_CONTACT_WORK_TIME | QUEUED_TIME | ABANDON_TIME | QUEUE_ANSWER_TIME | HOLD_TIME | INTERACTION_TIME | INTERACTION_AND_HOLD_TIME | SERVICE_LEVEL`   
Required: No

 ** Statistic **   <a name="connect-Type-HistoricalMetric-Statistic"></a>
The statistic for the metric.  
Type: String  
Valid Values: `SUM | MAX | AVG`   
Required: No

 ** Threshold **   <a name="connect-Type-HistoricalMetric-Threshold"></a>
The threshold for the metric, used with service level metrics.  
Type: [Threshold](API_Threshold.md) object  
Required: No

 ** Unit **   <a name="connect-Type-HistoricalMetric-Unit"></a>
The unit for the metric.  
Type: String  
Valid Values: `SECONDS | COUNT | PERCENT`   
Required: No

## See Also
<a name="API_HistoricalMetric_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/connect-2017-08-08/HistoricalMetric) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/connect-2017-08-08/HistoricalMetric) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/connect-2017-08-08/HistoricalMetric)