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

# aws-cdk.aws-codeguruprofiler — The CDK Construct Library for AWS::CodeGuruProfiler

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

## What it is and what it does

This package provides CDK constructs for Amazon CodeGuru Profiler, a service that collects runtime performance data from live applications and delivers optimization recommendations. It wraps the AWS::CodeGuruProfiler CloudFormation resource, allowing you to define profiling groups, configure compute platforms (such as AWS Lambda), and grant IAM permissions to application roles so profiling agents can publish data.

The package depends on aws-cdk.core, aws-cdk.aws-iam, constructs, jsii, publication, and typeguard. It is marked as Inactive (Development Status 7) and reached end-of-support on 2023-06-01; AWS explicitly directs users to migrate to AWS CDK v2 for ongoing support and updates.

Use it for:

- Set up a profiling group in CDK v1 infrastructure to collect performance metrics from Lambda functions or other compute platforms.
- Grant application execution roles permission to publish profiling data to CodeGuru Profiler via the grant_publish method.
- Configure compute platform settings (e.g., AWS_LAMBDA) when defining profiling groups in infrastructure-as-code.
- Integrate CodeGuru Profiler into existing CDK v1 stacks for application performance monitoring and tuning recommendations.

## Worth the install?

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

Provides AWS CDK constructs for defining and managing Amazon CodeGuru Profiler profiling groups, enabling runtime performance data collection and profiling agent integration in infrastructure-as-code.

No, unless you are maintaining an existing AWS CDK v1 codebase. This package is no longer updated and reached end-of-support on 2023-06-01. AWS explicitly recommends migrating to AWS CDK v2. For new projects, use the v2 equivalent instead.

## Install

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

## Installing aws-cdk.aws-codeguruprofiler

Before you install: Low install friction with a stable dependency chain. However, this is a v1 package that reached end-of-support on 2023-06-01 and is no longer being updated; AWS recommends migration to AWS CDK v2.

License in practice: Licensed under Apache-2.0 (permissive), imposing no restrictions on commercial or private use.

Quickstart:

import aws_cdk.aws_codeguruprofiler as codeguruprofiler
from aws_cdk import aws_iam as iam

profiling_group = codeguruprofiler.ProfilingGroup(self, "MyProfilingGroup")
publish_app_role = iam.Role(self, "PublishAppRole", assumed_by=iam.AccountRootPrincipal())
profiling_group.grant_publish(publish_app_role)

Requires AWS CDK v1 environment; AWS recommends migrating to CDK v2 instead of starting new v1 projects.

Verify before relying:

- Whether v1 packages remain functional in current AWS environments or if migration to v2 is mandatory for new deployments.
- Compatibility of this v1 construct with the latest AWS CodeGuru Profiler API features.

## Package facts

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

## Tags

aws cdk codeguru profiler, profiling group construct, runtime performance monitoring cdk, aws codeguru infrastructure as code, application profiler cdk, performance data collection aws, profiling agent permissions, aws-cdk, end-of-life, infrastructure-as-code

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