# Monitoring call analytics pipelines for the Amazon Chime SDK with Amazon CloudWatch
<a name="monitoring-with-cloudwatch"></a>

You can use Amazon CloudWatch to monitor Amazon Chime SDK call analytics pipelines. You can also set alarms that watch for certain thresholds, and send notifications or take actions when those thresholds are met. For more information about CloudWatch, see the [Amazon CloudWatch User Guide](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).

**Topics**
+ [Prerequisites](#monitoring-prereqs)
+ [Call analytics metrics](#monitoring-metrics)
+ [CloudWatch dimensions for pipeline metrics](#monitoring-dimensions)

## Prerequisites
<a name="monitoring-prereqs"></a>

To use CloudWatch metrics, you must first create a media pipelines service-linked role that grants permissions to publish service metrics to Amazon CloudWatch. For more information about the service-linked role, see [Creating a service-linked role for Amazon Chime SDK media pipelines](create-pipeline-role.md), in this guide.

## Call analytics metrics
<a name="monitoring-metrics"></a>

Amazon Chime SDK call analytics publishes the following metrics to the `AWS/ChimeSDK` namespace for media insights pipelines that you create by using a media insights configuration.


| Metric | Description | 
| --- | --- | 
|  `MediaInsightsPipelineCreated`  |  The media insights pipeline was successfully created. Unit: Count  | 
|  `MediaInsightsPipelineStopped`  |  The media insights pipeline was successfully stopped. Unit: Count  | 
|  `MediaInsightsPipelineFailed`  |  The media insights pipeline failed. Unit: Count  | 
|  `MediaInsightsPipelineDuration`  |  The time between pipeline creation and Stopped/Failed. Unit: Seconds  | 
|  `MediaInsightsPipelineBillingDuration`  |  The billing duration of the media insights pipeline. Unit: Count  | 
|  `RecordingFileSize`  |  The size of the recording file. Unit: Bytes  | 
|  `RecordingDuration `  |  The duration of the recording. Unit: Seconds  | 

## CloudWatch dimensions for pipeline metrics
<a name="monitoring-dimensions"></a>

The following table lists the CloudWatch dimensions that you can use to monitor call analytics pipelines.


| Dimension | Description | 
| --- | --- | 
| `MediaInsightsPipelineConfigurationId` | The ID of the media insights pipeline configuration. | 
| `MediaInsightsPipelineConfigurationName` | The name of the media insights pipeline configuration. |