Monitoring your instance using CloudWatch
Amazon Connect sends data about your instance to CloudWatch metrics so that you can collect, view, and analyze CloudWatch metrics for your Amazon Connect virtual contact center. You can use this data to monitor key operational metrics and set up alarms. Data about your contact center is sent to CloudWatch every 1 minute.
When you view the CloudWatch metrics dashboard, you can specify the refresh interval for the data displayed. The values displayed in the dashboard reflect the values for the refresh interval you define. For example, if you set the refresh interval to 1 minute, the values displayed are for a minute period. You can select a refresh interval of 10 seconds, but Amazon Connect does not send data more often than every 1 minute. Metrics that are sent to CloudWatch are available for two weeks, and then discarded. To learn more about metrics in CloudWatch, see the Amazon CloudWatch User Guide.
Note
If your Amazon Connect instance was created on or before October 2018, you need to provide Amazon Connect with permission to begin publishing chat metrics to your CloudWatch account. To do so, create an IAM policy with the following permission and attach it to the Amazon Connect service role. You can find the Amazon Connect service role on the Account overview page for your Amazon Connect instance.
{ "Effect": "Allow", "Action": "cloudwatch:PutMetricData", "Resource": "*", "Condition": { "StringEquals": { "cloudwatch:namespace": "AWS/Connect" } } }
Amazon Connect metrics sent to CloudWatch
The AWS/Connect
namespace includes the following metrics.
Metric | Description |
---|---|
CallsBreachingConcurrencyQuota |
The total number of voice calls that exceeded the concurrent calls quota for the instance. For the total number of calls that breach the quota, take a look at the Sum statistic. For example, assume your contact center experiences the following volumes, and your service quota is 100 concurrent calls:
CallsBreachingConcurrencyQuota = 110: the total number of voice calls that exceeded the quota between 0:00 and 0:10. Unit: Count Dimension:
|
CallBackNotDialableNumber |
The number of times a queued callback to a customer could not be dialed because the customer's number is in a country for which outbound calls are not allowed for the instance. The countries allowed for an instance are defined by the service quotas. Unit: Count Dimensions:
|
CallRecordingUploadError |
The number of call recordings that failed to upload to the Amazon S3 bucket configured for your instance. This is the bucket specified in Data Storage > Call Recordings settings for the instance. Unit: Count Dimensions:
|
CallsPerInterval |
The number of voice calls, both inbound and outbound, received or placed per second in the instance. Unit: Count Dimensions:
|
ChatsBreachingActiveChatQuota |
The total number of valid requests made to start a chat that exceeded the concurrent active chats quota for the instance. For the total number of chats requests that breach the quota, take a look at the Sum statistic. For example, assume your contact center experiences the following volumes, and your service quota is 2500 concurrent active chats:
ChatsBreachingActiveChatsQuota = 110: the total number of chats that exceeded the quota between 0:00 and 0:10. Unit: Count Dimensions:
|
ConcurrentActiveChats |
The number of concurrent active chats in the instance at the time the data is displayed in the dashboard. The value displayed for this metric is the number of concurrent active chats at the time the dashboard is displayed, and not a sum for the entire interval of the refresh interval set. All active chats are included, not only active chats that are connected to agents. While all statistics are available in CloudWatch for concurrent active chats, you might be most interested in looking at the Maximum/Average statistic. The Sum statistic isn't as useful here. Unit: Count Dimensions:
|
ConcurrentActiveChatsPercentage |
The percentage of the concurrent active chats service quota used in the instance. This is calculated by:
Where ConfiguredConcurrentActiveChatsLimit is the Concurrent active chats per instance configured for your instance. Unit: Percent (Output displays as an integer. For example, 1% of chats is shown as 1, not as 0.01.) Dimensions:
|
ConcurrentCalls |
The number of concurrent active voice calls in the instance at the time the data is displayed in the dashboard. The value displayed for this metric is the number of concurrent active calls at the time the dashboard is displayed, and not a sum for the entire interval of the refresh interval set. All active voice calls are included, not only active calls that are connected to agents. While all statistics are available in CloudWatch for concurrent voice calls you might be most interested in looking at the Maximum/Average statistic. The Sum statistic isn't as useful here. Unit: Count Dimensions:
|
ConcurrentCallsPercentage |
The percentage of the concurrent active voice calls service quota used in the instance. This is calculated by:
Unit: Percent (output displays as a decimal) Dimensions:
|
ConcurrentTasks |
The number of concurrent active tasks in the instance at the time the data is displayed in the dashboard. The value displayed for this metric is the number of concurrent active tasks at the time the dashboard is displayed, and not a sum for the entire interval of the refresh interval set. All active tasks are included, not only active tasks that are connected to agents. While all statistics are available in CloudWatch for concurrent tasks you might be most interested in looking at the Maximum/Average statistic. The Sum statistic isn't as useful here. Unit: Count Dimensions:
|
ConcurrentTasksPercentage |
The percentage of the concurrent active tasks service quota used in the instance. This is calculated by:
Where ConfiguredConcurrentTasksLimit is the Concurrent tasks per instance configured for your instance. Unit: Percent (output displays as a decimal) Dimensions:
|
ContactFlowErrors |
The number of times the error branch for a flow was run. Unit: Count Dimensions:
|
ContactFlowFatalErrors |
The number of times a flow failed to execute due to a system error. Unit: Count Dimensions:
|
LongestQueueWaitTime |
The longest amount of time, in seconds, that a contact waited in a queue. This is the length of time a contact waited in a queue during the refresh interval selected in the CloudWatch dashboard, such as 1 minute or 5 minutes. Unit: Seconds Dimensions:
|
MissedCalls |
The number of voice calls that were missed by agents during the refresh interval selected, such as 1 minute or 5 minutes. A missed call is one that is not answered by an agent within 20 seconds. To monitor the total missed calls in a given time period, take a look at the Sum statistic in CloudWatch. Unit: Count Dimensions:
|
MisconfiguredPhoneNumbers |
The number of calls that failed because the phone number is not associated with a flow. Unit: Count Dimensions:
|
PublicSigningKeyUsage |
The number of times a flow security key (public signing key) was used to encrypt customer input in a flow. Unit: Count Dimensions:
|
QueueCapacityExceededError |
The number of calls that were rejected because the queue was full. Unit: Count Dimensions:
|
QueueSize |
The number of contacts in the queue. The value reflects the number of contacts in the queue at the time the dashboard is accessed, not for the duration of the reporting interval. Unit: Count Dimensions:
|
SuccessfulChatsPerInterval |
The number of chats successfully started in the instance for the defined interval. Unit: Count Dimensions:
|
TasksBreachingConcurrencyQuota |
The total number of tasks that exceeded the concurrent tasks quota for the instance. For the total number of tasks that breach the quota, take a look at the Sum statistic. For example, assume your contact center experiences the following volumes, and your service quota is 2500 concurrent tasks:
TasksBreachingConcurrencyQuota = 110: the total number of tasks that exceeded the quota between 0:00 and 0:10. Unit: Count Dimensions:
|
TasksExpired |
Tasks which have expired after being active for 7 days. To monitor the total number of tasks that have expired in a given time period, take a look at the Sum statistic in CloudWatch. Unit: Count Dimensions:
|
TasksExpiryWarningReached |
Tasks that have been active for 6 days 22 hours and reached expiry warning limit. To monitor the total number of tasks that have reached expiry warning limit in a given time period, take a look at the Sum statistic in CloudWatch. Unit: Count Dimensions:
|
ThrottledCalls |
The number of voice calls that were rejected because the rate of calls per second exceeded the maximum supported quota. To increase the supported rate of calls, request an increase in the service quota for concurrent active calls per instance. To monitor the total throttled calls in a given time period, take a look at the Sum statistic in CloudWatch. Unit: Seconds Unit: Count Dimensions:
|
ToInstancePacketLossRate |
The ratio of packet loss for calls in the instance, reported every 10 seconds. Each data point is between 0 and 100. The ratio of packet loss for calls in the instance appears as a percent between 0 and 1. Unit: Percent Dimensions:
|
Amazon Connect CloudWatch metrics dimensions
In CloudWatch, a dimension is a name/value pair that uniquely identifies a metric. In the dashboard, metrics are grouped by dimension. When you view metrics in the dashboard, only metrics with data are displayed. If there is no activity during the refresh interval for which there is a metric, then no data from your instance is displayed in the dashboard.
The following dimensions are used in the CloudWatch dashboard for Amazon Connect metrics.
Flow metrics dimension
Note
Queue names must contain only the following characters in order for it to be displayed in CloudWatch: alphanumeric characters (0-9A-Za-z), period (.), hyphen (-), underscore (_), forward slash (/), hash (#), colon (:), comma (,), dollar ($), at sign (@), vertical bar (|), ampersand (&), opening brace ({), closing brace (}), plus (+), question mark (?), percent sign (%), and the space character.
Filters metric data by flow. Includes the following metrics:
-
ContactFlowErrors
-
ContactFlowFatalErrors
-
PublicSigningKeyUsage
Contact metrics dimension
Filters metric data by contacts. Includes the following metrics:
-
TasksExpiryWarningReached
-
TasksExpired
Instance metrics dimension
Filters meta data by instance. Includes the following metrics:
-
CallsBreachingConcurrencyQuota
-
CallsPerInterval
-
CallRecordingUploadError
-
ChatsBreachingActiveChatQuota
-
ConcurrentActiveChats
-
ConcurrentActiveChatsPercentage
-
ConcurrentCalls
-
ConcurrentCallsPercentage
-
ConcurrentTasks
-
ConcurrentTasksPercentage
-
MisconfiguredPhoneNumbers
-
MissedCalls
-
SuccessfulChatsPerInterval
-
TasksBreachingConcurrencyQuota
-
ThrottledCalls
Instance ID, Participant, Stream Type, Type of Connection
Filters metric data by connection. Includes the following metrics:
-
ToInstancePacketLossRate
Queue metrics dimension
Note
If a queue has a dimension name in non-ASCII characters, you won't be able to see it in CloudWatch.
Filters metric data by queue. Includes the following metrics:
-
CallBackNotDialableNumber
-
LongestQueueWaitTime
-
QueueCapacityExceededError
-
QueueSize
Amazon Connect Voice ID metrics sent to CloudWatch
The VoiceID
namespace includes the following metrics.
- RequestLatency
-
The elapsed time for the request.
Frequency: 1 minute
Unit: Milliseconds
Dimension: API
- UserErrors
-
The number of Error counts due to bad requests from user.
Frequency: 1 minute
Unit: Count
Dimension: API
- SystemErrors
-
The number of Error counts due to internal service error.
Frequency: 1 minute
Unit: Count
Dimension: API
- Throttles
-
The number of requests that are rejected due to exceeding the max rate allowed for sending requests.
Frequency: 1 minute
Unit: Count
Dimension: API
- ActiveSessions
-
The number of active sessions in the domain. Active sessions are sessions that are in pending or ongoing status.
Frequency: 1 minute
Unit: Count
Dimension: Domain
- ActiveSpeakerEnrollmentJobs
-
The number of active Batch Enrollment Jobs in the domain. Active Jobs are those which are in Pending or InProgress status.
Frequency: 15 minutes
Unit: Count
Dimension: Domain
- ActiveFraudsterRegistrationJobs
-
The number of active Batch Registration Jobs in the domain. Active Jobs are those which are in Pending or InProgress status.
Frequency: 15 minutes
Unit: Count
Dimension: Domain
- Speakers
-
The number of Speakers in the domain.
Frequency: 15 minutes
Unit: Count
Dimension: Domain
- Fraudsters
-
The number of Fraudsters in the domain.
Frequency: 15 minutes
Unit: Count
Dimension: Domain
Amazon Connect Voice ID metrics dimensions
The following dimensions are used in the CloudWatch dashboard for Amazon Connect Voice ID metrics. When you view metrics in the dashboard, only metrics with data are displayed. If there is no activity during the refresh interval for which there is a metric, then no data from your instance is displayed in the dashboard.
API metrics dimension
This dimension limits the data to one of the following Voice ID operations:
-
DeleteFraudster
-
EvaluateSession
-
ListSpeakers
-
DeleteSpeaker
-
OptOutSpeaker
Domain metrics dimension
The Voice ID domain where the enrollment, authentication or registration is conducted.
Amazon AppIntegrations metrics sent to CloudWatch
The AWS/AppIntegrations
namespace includes the following metrics.
- RecordsDownloaded
-
The number of records that were successfully downloaded as part of an AppFlow flow execution for a data integration.
Frequency: 1 minute
Unit: Count
Valid Statistics: Maximum, Sum, Minimum, Average
- RecordsFailed
-
The number of records that failed to download as part of an AppFlow flow execution for a data integration.
Frequency: 1 minute
Unit: Count
Valid Statistics: Maximum, Sum, Minimum, Average
- DataDownloaded
-
The number of bytes that were successfully downloaded as part of an AppFlow flow execution for a data integration.
Frequency: 1 minute
Unit: Bytes
Valid Statistics: Maximum, Sum, Minimum, Average
- DataProcessingDuration
-
The time it took to process and download data as part of a single AppFlow flow execution for a data integration.
Frequency: 1 minute
Unit: Milliseconds
Valid Statistics: Maximum, Sum, Minimum, Average
- EventsReceived
-
The number of events that were successfully emitted from your third-party source application (Salesforce, Zendesk) and received on your event bus.
Frequency: 1 minute
Unit: Count
Valid Statistics: Maximum, Sum, Minimum, Average
- EventsProcessed
-
The number of events that were successfully processed and forwarded to be evaluated against the rules you configured on an event integration.
Frequency: 1 minute
Unit: Count
Valid Statistics: Maximum, Sum, Minimum, Average
- EventsThrottled
-
The number of events that were throttled because the rate of emitting events exceeded the maximum supported quota.
Frequency: 1 minute
Unit: Bytes
Valid Statistics: Maximum, Sum, Minimum, Average
- EventsFailed
-
The number of events that failed to process due to malformed or unsupported third-party events, and other processing errors .
Frequency: 1 minute
Unit: Bytes
Valid Statistics: Maximum, Sum, Minimum, Average
- EventProcessingDuration
-
The time it took to successfully process and forward an event to be evaluated against the rules you configured on an event integration.
Frequency: 1 minute
Unit: Milliseconds
Valid Statistics: Maximum, Sum, Minimum, Average
Amazon AppIntegrations metric dimensions
You can use the following dimensions to refine AppIntegrations metrics.
Dimension | Description |
---|---|
AccountId |
AWS account ID |
ClientId |
Service principal of the client |
IntegrationARN |
ARN of the event or data integration |
IntegrationType |
DataIntegration or EventIntegration |
Region |
Region of the data or event integration |
Amazon Connect Customer Profiles metrics
The AWS/CustomerProfiles
namespace includes the following metrics.
Real-time export metrics sent to CloudWatch
The two following metrics will be published to CloudWatch for every export task. These metrics will provide information on your export stream tasks and will allow you to configure your Kinesis streams based on your use case. In the case of being throttled, these metrics will enable you to provision your Kinesis stream to ensure delivery to your destination.
- EventsProcessed
-
Number of records successfully streamed into a Kinesis Stream.
Unit: Count
- EventsThrottled
-
Number of PutRecord attempts that encountered throttling exception.
Unit: Count
Amazon Connect Customer Profiles metric dimensions
You can use the following dimensions to refine Customer Profiles metrics.
Dimension | Description |
---|---|
DomainName |
Customer Profiles domain name |
DestinationType |
Type of destination. Available value is: Kinesis |
DestinationName |
Name of destination. Kinesis Data Streaming name for DestinationType: Kinesis. |
Use CloudWatch metrics to calculate concurrent call quota
Important
The ConcurrentCallsPercentage calculation information is not the same as ConcurrentTasksPercentage and ConcurrentChatPercentage.
-
The metrics emitted for ConcurrentCallsPercentage are in decimal and not multiplied by 100. The metric represents a percentage of your total quota.
-
For ConcurrentTasksPercentage and ConcurrentChatPercentage the value is multiplied by 100. That gives you your total quota.
-
The metrics emitted are correct and there is no discrepancy in data.
Here's how to calculate your quota usage for concurrent calls.
With calls active in the system, look at ConcurrentCalls and ConcurrentCallsPercentage. Calculate how much of your quota has been used:
-
(ConcurrentCalls / ConcurrentCallsPercentage)
For example, if ConcurrentCalls is 20 and ConcurrentCallsPercentage is 50, your quota usage is calculated as (20/0.5) = 40. Your total quota is 40 calls.
Use CloudWatch metrics to calculate concurrent active chats quota
Here's how to calculate your quota for concurrent active chats.
With chats active in the system, look at ConcurrentActiveChats and ConcurrentChatsPercentage. Calculate the quota:
-
(ConcurrentActiveChats / ConcurrentActiveChatsPercentage) * 100
For example, if ConcurrentActiveChats is 1000 and ConcurrentActiveChatsPercentage is 50, your quota is calculated as (1000/50)*100 = 2000. Your total quota is 2000 chats.
Use CloudWatch metrics to calculate concurrent task quota
Here's how to calculate your quota for concurrent tasks.
With tasks active in the system, look at ConcurrentTasks and ConcurrentTasksPercentage. Calculate the quota:
-
(ConcurrentTasks / ConcurrentTasksPercentage)*100
For example, if ConcurrentTasks is 20 and ConcurrentTasksPercentage is 50, your total quota is calculated as (20/50)*100= 40. Your total quota is 40 tasks.