aws-cdk.aws-cloudwatch

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 on this page — 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

aws-cdk-aws-cloudwatch on PyPI

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

Evidence: aws_cdk.aws_cloudwatch-1.204.0-py3-none-any.whl

Tags

More Monitoring packages