@aws-cdk/aws-codeguruprofiler

AWS::CodeGuruProfiler Construct Library

---

All classes with the Cfn prefix in this module (CFN Resources) are always stable and safe to use.

The APIs of higher level constructs in this module are experimental and under active development. They are subject to non-backward compatible changes or removal in any future version. These are not subject to the Semantic Versioning model and breaking changes will be announced in the release notes. This means that while you may use them, you may need to update your source code when upgrading to a newer version of this package.

---

Amazon CodeGuru Profiler collects runtime performance data from your live applications, and provides recommendations that can help you fine-tune your application performance.

Installation

Import to your project:

import * as codeguruprofiler from '@aws-cdk/aws-codeguruprofiler';

Basic usage

Here's how to setup a profiling group and give your compute role permissions to publish to the profiling group to the profiling agent can publish profiling information:

// The execution role of your application that publishes to the ProfilingGroup via CodeGuru Profiler Profiling Agent. (the following is merely an example)
const publishAppRole = new Role(stack, 'PublishAppRole', {
  assumedBy: new AccountRootPrincipal(),
});

const profilingGroup = new ProfilingGroup(stack, 'MyProfilingGroup');
profilingGroup.grantPublish(publishAppRole);

Compute Platform configuration

Code Guru Profiler supports multiple compute environments. They can be configured when creating a Profiling Group by using the computePlatform property:

const profilingGroup = new ProfilingGroup(stack, 'MyProfilingGroup', {
  computePlatform: ComputePlatform.AWS_LAMBDA,
});

Changelog

1.71.0 (2020-10-29)

⚠ BREAKING CHANGES TO EXPERIMENTAL FEATURES

• synthetics: runtime is now a required property.

⚠ BREAKING CHANGES TO EXPERIMENTAL FEATURES

• core: Creation stack traces for Lazy values are no longer captured by default. The CDK_DEBUG=true environment variable must be set in order to capture stack traces (this is also achieved by using the --debug option of the cdk CLI). Users should not need those stack traces most of the time, and should only enable creation stack trace captures when tyring to troubleshoot a resolution error that they are otherwise unable to trace back.

Features

• autoscaling: CloudFormation init for ASGs (#9674) (bdf1d30), closes #9065 #9664
• cli: --all flag to select all stacks (#10745) (bcd9d0a), closes #3222
• cli: change virtualenv directory to .venv to comply with python recommendation (#10995) (a4a41b5), closes #9134
• cli: disable version check (#10975) (575e47e), closes #10974
• core: make creationStack collection for Lazy opt-in (#11170) (a3fae02)
• init-templates: Java init template tests updated to JUnit 5 (#11101) (e0c00a1), closes #10694
• upgrade "constructs" to 3.2.0 (#11145) (d85e3ed)
• redshift: add publiclyAccessible prop (#11162) (9f8a6de), closes #11161
• stepfunctions-tasks: Support for Athena APIs: StartQueryExecution, StopQueryExeuction, GetQueryResults and GetQueryExecution (#11045) (19180cc)
• synthetics: The CloudWatch Synthetics Construct Library is now in Developer Preview (#11180) (b3b5f48)

Bug Fixes

• aws-rds/aws-secretmanager: credentials.fromSecret does not access secretsmanager.ISecret (#11033) (35ad608), closes #11015
• bootstrap: same-account modern bootstrapping still requires policy ARNs (#9867) (f5ab374), closes #8571
• codebuild: ReportGroup name is ignored (#11080) (1e2250a), closes #11052
• core: assets are duplicated between nested Cloud Assemblies (#11008) (c84217f), closes #10877 #9627 #9917
• ec2: CfnInit cannot be used with custom constructs (#11167) (01c52c8)
• region-info: incorrect S3 static website endpoint for us-gov-west-1 (#10920) (dde9c55), closes 40aws-cdk/region-info/build-tools/generate-static-data.ts#L47-L49