---
id: aws-cdk-aws-cloudwatch
version: "1.204.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# aws-cdk.aws-cloudwatch — The CDK Construct Library for AWS::CloudWatch

License: permissive · Maintenance: active · Downloads: 189.8K/mo

## What it is and what it does

This package provides AWS CDK v1 constructs for defining CloudWatch monitoring infrastructure—metrics, alarms, and dashboards—as Python code. It allows you to instantiate Metric objects to represent CloudWatch metrics (either from AWS services or custom applications), compose them using MathExpression for calculations, and create alarms with thresholds and actions. Metrics can be account and region aware, and the library supports search expressions and cross-account/cross-region monitoring.

However, this is a v1 package that reached end-of-support on 2023-06-01 and is no longer maintained. The package depends on aws-cdk.core, aws-cdk.aws-iam, constructs, jsii, publication, and typeguard. New projects should use AWS CDK v2 instead; existing v1 users should plan a migration.

Use it for:

- Define CloudWatch alarms on Lambda error metrics programmatically within a CDK stack.
- Create custom metrics for application-specific monitoring using Metric objects with custom namespaces.
- Build metric math expressions to combine multiple metrics (e.g., error rate as errors/invocations).
- Set up cross-account or cross-region alarms by attaching metrics to constructs with account/region context.
- Search for and aggregate metrics across multiple resources using search expressions in MathExpression.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Defines CloudWatch metrics, alarms, and dashboards as code using AWS CDK v1 constructs, enabling programmatic monitoring infrastructure for AWS resources.

No—this is AWS CDK v1, which reached end-of-support on 2023-06-01 and is no longer being updated. New projects should use AWS CDK v2 instead. Existing v1 users should plan a migration to v2 as soon as feasible. Install only if you are maintaining a legacy CDK v1 codebase with no near-term migration path.

## Install

pip install aws-cdk-aws-cloudwatch
uv add aws-cdk-aws-cloudwatch
poetry add aws-cdk-aws-cloudwatch

## Installing aws-cdk.aws-cloudwatch

Before you install: Low install friction with a wheel distribution. However, this is AWS CDK v1, which reached end-of-support on 2023-06-01 and is no longer being updated—users should migrate to AWS CDK v2 instead.

License in practice: Licensed under Apache-2.0 (permissive), allowing use in commercial and open-source projects with minimal restrictions.

Quickstart:

pip install aws-cdk.aws-cloudwatch

import aws_cdk.aws_cloudwatch as cloudwatch

metric = cloudwatch.Metric(
    namespace="MyNamespace",
    metric_name="MyMetric",
    dimensions_map={"ProcessingStep": "Download"}
)

Requires AWS CDK v1 environment; v1 is end-of-support as of 2023-06-01 and users should migrate to AWS CDK v2.

Verify before relying:

- Whether existing CDK v1 projects can coexist safely with v2 during migration.
- Availability and completeness of CloudWatch feature parity in AWS CDK v2 equivalent.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 189.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

cloudwatch metrics as code, aws cdk monitoring, alarm definitions infrastructure, metric math expressions, cloudwatch dashboard construct, aws monitoring infrastructure, cdk v1 cloudwatch, aws-infrastructure, end-of-support, cdk-v1

[View on SkillFed](https://skillfed.io/packages/aws-cdk-aws-cloudwatch) · [View on PyPI](https://pypi.org/project/aws-cdk-aws-cloudwatch/)