aws-cdk.aws-logs
The CDK Construct Library for AWS::Logs
What it is and what it does
This package provides AWS CDK v1 constructs for defining CloudWatch Logs infrastructure in Python. It lets you declare log groups with configurable retention periods, set up log stream subscriptions to Lambda or Kinesis, create metric filters to extract metrics from logs, and manage resource policies for cross-service access. The constructs generate CloudFormation templates that AWS deploys on your behalf.
The library integrates with other AWS CDK modules (IAM, KMS, S3, CloudWatch) to handle encryption, permissions, and monitoring. However, AWS CDK v1 reached end-of-support on 2023-06-01 and is no longer maintained; the AWS team recommends migrating to AWS CDK v2 for new projects and existing deployments.
Use it for:
- Define log groups with specific retention policies (e.g., one week) in infrastructure-as-code templates
- Route filtered log events from CloudWatch to Lambda functions or Kinesis streams for downstream processing
- Extract numeric values from JSON-structured logs and emit them as CloudWatch metrics for alarming
- Encrypt log group data with customer-managed KMS keys for compliance requirements
- Manage log retention for log groups auto-created by AWS services like Lambda using LogRetention construct
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
Provides AWS CDK constructs for creating and managing CloudWatch Logs resources, including log groups, streams, retention policies, subscriptions, and metric filters.
No—this is AWS CDK v1, which reached end-of-support on 2023-06-01 and is no longer updated. For new projects, use AWS CDK v2 instead. For existing v1 deployments, plan a migration to v2 to maintain security and feature support.
Install
aws-cdk-aws-logs on PyPI
pip
pip install aws-cdk-aws-logsuv
uv add aws-cdk-aws-logspoetry
poetry add aws-cdk-aws-logsInstalling aws-cdk.aws-logs
Before you install
Low install friction with a pure-Python wheel. 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 commercial and private use with minimal restrictions.
Quickstart
pip install aws-cdk.aws-logs
from aws_cdk import aws_logs as logs
from aws_cdk import core
stack = core.Stack()
log_group = logs.LogGroup(stack, "MyLogGroup",
retention=logs.RetentionDays.ONE_WEEK
)
Requires AWS CDK v1 core library; AWS CDK v1 is end-of-support as of 2023-06-01 and v2 is recommended for new projects.
Verify before relying
- Whether existing v1 projects can safely remain on this package or face security/compatibility risks post-EOL
- Migration path complexity and effort for moving from v1 to v2 constructs
Package facts
| License | Apache-2.0 (permissive) |
| Python support | supports the current Python release (~=3.7) |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | 10 — aws-cdk.aws-cloudwatch, aws-cdk.aws-iam, aws-cdk.aws-kms, aws-cdk.aws-s3-assets, aws-cdk.core, aws-cdk.cx-api, constructs, jsii, publication, typeguard |
| Maintenance | actively maintained — 1,152 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 186,512/month — #9,982 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: aws_cdk.aws_logs-1.204.0-py3-none-any.whl
Tags
More Build Tools packages
Provides reusable utilities for Python…
permissive · top 100 on PyPI
tqdmWraps any iterable to display a real-time…
copyleft · top 100 on PyPI
pippip is the standard installer for Python…
permissive · top 100 on PyPI
hatchlingHatchling is a standards-compliant Python build…
permissive · top 100 on PyPI
grpcio-toolsGenerates Python gRPC service stubs and message…
permissive · top 1,000 on PyPI
pre-commitpre-commit is a framework for installing and…
permissive · top 1,000 on PyPI
aws-cdk.aws-cloudwatchDefines CloudWatch metrics, alarms, and…
permissive · top 15,000 on PyPI
awslogsawslogs is a command-line tool for querying and…
permissive · top 15,000 on PyPI
aws-embedded-metricsGenerates CloudWatch metrics embedded within…
permissive · top 5,000 on PyPI
cloudwatchA Python logging handler that sends log events…
permissive · top 15,000 on PyPI
kappaKappa is a command-line tool that automates the…
permissive · top 15,000 on PyPI
aws-cdk.aws-kinesisanalytics-flink-alphaProvides AWS CDK constructs for defining and…
permissive · top 15,000 on PyPI
aws-cdk.aws-snsProvides AWS CDK constructs for defining Amazon…
permissive · top 15,000 on PyPI
aws-cdk.aws-iot-actions-alphaProvides AWS CDK constructs that define actions…
permissive · top 15,000 on PyPI
aws-cdk.aws-neptune-alphaProvides AWS CDK constructs for defining and…
permissive · top 15,000 on PyPI
cdk-cloudformation-datadog-monitors-monitorProvides an AWS CDK L1 construct for defining…
permissive · top 15,000 on PyPI