# MetricFilterV2


Contains information about the filter used when retrieving metrics. `MetricFiltersV2` can be used on the following metrics: `AVG_AGENT_CONNECTING_TIME`, `CONTACTS_CREATED`, `CONTACTS_HANDLED`, `SUM_CONTACTS_DISCONNECTED`.

## Contents


 ** MetricFilterKey **   <a name="connect-Type-MetricFilterV2-MetricFilterKey"></a>
The key to use for filtering data.   
Valid metric filter keys:   
+ ANSWERING\$1MACHINE\$1DETECTION\$1STATUS
+ CASE\$1STATUS
+ DISCONNECT\$1REASON
+ FLOWS\$1ACTION\$1IDENTIFIER
+ FLOWS\$1NEXT\$1ACTION\$1IDENTIFIER
+ FLOWS\$1OUTCOME\$1TYPE
+ FLOWS\$1RESOURCE\$1TYPE
+ INITIATION\$1METHOD
Type: String  
Required: No

 ** MetricFilterValues **   <a name="connect-Type-MetricFilterV2-MetricFilterValues"></a>
The values to use for filtering data. Values for metric-level filters can be either a fixed set of values or a customized list, depending on the use case.  
For valid values of metric-level filters `INITIATION_METHOD`, `DISCONNECT_REASON`, and `ANSWERING_MACHINE_DETECTION_STATUS`, see [ContactTraceRecord](https://docs.aws.amazon.com/connect/latest/adminguide/ctr-data-model.html#ctr-ContactTraceRecord) in the *Amazon Connect Administrator Guide*.   
For valid values of the metric-level filter `FLOWS_OUTCOME_TYPE`, see the description for the [Flow outcome](https://docs.aws.amazon.com/connect/latest/adminguide/metrics-definitions.html#flows-outcome) metric in the *Amazon Connect Administrator Guide*.  
For valid values of the metric-level filter `BOT_CONVERSATION_OUTCOME_TYPE`, see the description for the [Bot conversations completed](https://docs.aws.amazon.com/connect/latest/adminguide/bot-metrics.html#bot-conversations-completed-metric) in the *Amazon Connect Administrator Guide*.  
For valid values of the metric-level filter `BOT_INTENT_OUTCOME_TYPE`, see the description for the [Bot intents completed](https://docs.aws.amazon.com/connect/latest/adminguide/bot-metrics.html#bot-intents-completed-metric) metric in the *Amazon Connect Administrator Guide*.  
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 10 items.  
Required: No

 ** Negate **   <a name="connect-Type-MetricFilterV2-Negate"></a>
If set to `true`, the API response contains results that filter out the results matched by the metric-level filters condition. By default, `Negate` is set to `false`.   
Type: Boolean  
Required: No

## See Also


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/MetricFilterV2) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/connect-2017-08-08/MetricFilterV2) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/connect-2017-08-08/MetricFilterV2)