---
title: Amazon Polly
description: Amazon Polly is a service that turns text into lifelike speech.
breadcrumbs: Docs > Integrations > Amazon Polly
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Amazon Polly
Integration version1.0.0
{% callout %}
# Important note for users on the following Datadog sites: us2.ddog-gov.com

{% alert level="info" %}
To find out if this integration is available in your organization, see your [Datadog Integrations](https://app.datadoghq.com/integrations) page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email [support@ddog-gov.com](mailto:support@ddog-gov.com).
{% /alert %}

{% /callout %}

## Overview{% #overview %}

Amazon Polly is a service that turns text into lifelike speech.

Enable this integration to see in Datadog all your Polly metrics.

## Setup{% #setup %}

### Installation{% #installation %}

If you haven't already, set up the [Amazon Web Services integration first](https://docs.datadoghq.com/integrations/amazon_web_services.md).

### Metric collection{% #metric-collection %}

1. In the [AWS integration page](https://app.datadoghq.com/integrations/amazon-web-services), ensure that `Polly` is enabled under the `Metric Collection` tab.
1. Install the [Datadog - Amazon Polly integration](https://app.datadoghq.com/integrations/amazon-polly).

### Log collection{% #log-collection %}

#### Enable logging{% #enable-logging %}

Configure Amazon Polly to send logs either to a S3 bucket or to CloudWatch.

**Note**: If you log to a S3 bucket, make sure that `amazon_polly` is set as *Target prefix*.

#### Send logs to Datadog{% #send-logs-to-datadog %}

1. If you haven't already, set up the [Datadog Forwarder Lambda function](https://docs.datadoghq.com/logs/guide/forwarder.md).

1. Once the Lambda function is installed, manually add a trigger on the S3 bucket or CloudWatch log group that contains your Amazon Polly logs in the AWS console:

   - [Add a manual trigger on the S3 bucket](https://docs.datadoghq.com/logs/guide/send-aws-services-logs-with-the-datadog-lambda-function.md#collecting-logs-from-s3-buckets)
   - [Add a manual trigger on the CloudWatch Log Group](https://docs.datadoghq.com/logs/guide/send-aws-services-logs-with-the-datadog-lambda-function.md#collecting-logs-from-cloudwatch-log-group)

## Data Collected{% #data-collected %}

### Metrics{% #metrics %}

|  |
|  |
| **aws.polly.2xxcount**(count)                      | The number of successful (2xx) responses returned by the Polly API.*Shown as success*                                   |
| **aws.polly.4xxcount**(count)                      | The number of client error (4xx) responses returned by the Polly API.*Shown as error*                                   |
| **aws.polly.5xxcount**(count)                      | The number of server error (5xx) responses returned by the Polly API.*Shown as error*                                   |
| **aws.polly.request\_characters**(gauge)           | The average number of characters in the request. This is billable characters only and does not include SSML tags.       |
| **aws.polly.request\_characters.maximum**(gauge)   | The maximum number of characters in the request. This is billable characters only and does not include SSML tags.       |
| **aws.polly.request\_characters.minimum**(gauge)   | The minimum number of characters in the request. This is billable characters only and does not include SSML tags.       |
| **aws.polly.request\_characters.sum**(count)       | The total number of characters in the request. This is billable characters only and does not include SSML tags.         |
| **aws.polly.response\_latency**(gauge)             | The average latency between when the request was made and the start of the streaming response.*Shown as millisecond*    |
| **aws.polly.response\_latency.maximum**(gauge)     | The maximum latency between when the request was made and the start of the streaming response.*Shown as millisecond*    |
| **aws.polly.response\_latency.minimum**(gauge)     | The minimum latency between when the request was made and the start of the streaming response.*Shown as millisecond*    |
| **aws.polly.response\_latency.samplecount**(count) | The total number of successful responses*Shown as response*                                                             |
| **aws.polly.response\_latency.sum**(count)         | The sum of the latency between when the request was made and the start of the streaming response.*Shown as millisecond* |

Each of the metrics retrieved from AWS are assigned the same tags that appear in the AWS console, including but not limited to host name, security-groups, and more.

### Events{% #events %}

The Amazon Polly integration does not include any events.

### Service Checks{% #service-checks %}

The Amazon Polly integration does not include any service checks.

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).