--- title: CloudWatch description: Adapter for cloudwatch metrics. location: https://istio.io/docs/reference/config/policy-and-telemetry/adapters/cloudwatch.html layout: protoc-gen-docs generator: protoc-gen-docs supported_templates: logentry supported_templates: metric aliases: - /docs/reference/config/adapters/cloudwatch.html number_of_entries: 4 ---

The CloudWatch adapter enables Istio to deliver metrics to Amazon CloudWatch. Amazon CloudWatch and logs to Amazon CloudWatchLogs.

To push metrics and logs to CloudWatch using this adapter you must provide AWS credentials to the AWS SDK. (see AWS docs).

The handler configuration must contain the same metrics as the instance configuration. The metrics specified in both instance and handler configurations will be sent to CloudWatch.

This adapter supports the metric template.

## Params

Configuration for the `cloudwatch` adapter.

Field | Type | Description | Required
--- | --- | --- | ---
`namespace` | `string` | CloudWatch metric namespace. | No
`metricInfo` | `map<string, MetricDatum>` | A map of Istio metric name to CloudWatch metric info. | No
`logGroupName` | `string` | The name of the log group in cloudwatchlogs. | No
`logStreamName` | `string` | The name of the log stream in cloudwatchlogs. | No
`logs` | `map<string, LogInfo>` | A map of Istio logentry name to CloudWatch logentry info. | No

## Params.MetricDatum

CloudWatch metric format.

Field | Type | Description | Required
--- | --- | --- | ---
`unit` | `Unit` | The unit of the metric. Must be valid cloudwatch unit value. CloudWatch docs | No

## Params.LogInfo

Field | Type | Description | Required
--- | --- | --- | ---
`payloadTemplate` | `string` | A golang text/template template that will be executed to construct the payload for this log entry. It will be given the full set of variables for the log to use to construct its result. | No

## Params.MetricDatum.Unit

Name | Description
--- | ---
`None` |
`Seconds` |
`Microseconds` |
`Milliseconds` |
`Count` |
`Bytes` |
`Kilobytes` |
`Megabytes` |
`Gigabytes` |
`Terabytes` |
`Bits` |
`Kilobits` |
`Megabits` |
`Gigabits` |
`Terabits` |
`Percent` |
`Bytes_Second` |
`Kilobytes_Second` |
`Megabytes_Second` |
`Gigabytes_Second` |
`Terabytes_Second` |
`Bits_Second` |
`Kilobits_Second` |
`Megabits_Second` |
`Gigabits_Second` |
`Terabits_Second` |
`Count_Second` |