chore: Cold start with provisioned concurrency support

[hjgraca]

Please provide the issue number

Issue number: #833

Summary

Changes

Add LambdaLifecycleTracker to manage cold start

This pull request introduces several updates to the AWS Lambda Powertools library, focusing on tracking Lambda lifecycle states, particularly cold starts, and improving initialization type handling. The most important changes include adding a new LambdaLifecycleTracker class, updating interfaces and constants, and incorporating the tracker into various aspects of the library.

Lambda lifecycle tracking and initialization type handling:

• New LambdaLifecycleTracker class:

  • Added to track Lambda lifecycle states, including cold starts. This class uses static flags and AsyncLocal to maintain state across invocations.

• Updates to IPowertoolsConfigurations interface:

  • Added IsColdStart and AwsInitializationType properties to indicate cold start status and Lambda initialization type, respectively.

• Constants update:

  • Added AWSInitializationTypeEnv constant for the AWS_LAMBDA_INITIALIZATION_TYPE environment variable to determine the Lambda function's initialization type.

Integration of LambdaLifecycleTracker:

• LoggingAspect:

  • Replaced the _isColdStart flag with LambdaLifecycleTracker.IsColdStart for cold start tracking.

• MetricsAspect:

  • Replaced the _isColdStart flag with LambdaLifecycleTracker.IsColdStart and updated the reset logic. [1] [2]

• TracingAspect:

  • Replaced the _isColdStart flag with LambdaLifecycleTracker.IsColdStart and updated the reset logic. [1] [2]

Testing and version updates:

• New tests for LambdaLifecycleTracker:

  • Added comprehensive unit tests to ensure correct behavior of the cold start tracking logic.

• Version updates:

  • Updated version numbers for Logging, Metrics, and Tracing components in version.json.

User experience

Please share what the user experience looks like before and after this change

Checklist

Please leave checklist items unchecked if they do not apply to your change.

• Meets tenets criteria
• I have performed a self-review of this change
• Changes have been tested
• Changes are documented
• PR title follows conventional commit semantics

Is this a breaking change?

RFC issue number:

Checklist:

• Migration process documented
• Implement warnings (if it can live side by side)

Acknowledgment

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Disclaimer: We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.

[Copilot]

Copilot reviewed 10 out of 11 changed files in this pull request and generated no comments.

Files not reviewed (1)

• version.json: Language not supported

Comments suppressed due to low confidence (1)

libraries/src/AWS.Lambda.Powertools.Common/Core/LambdaLifecycleTracker.cs:12

• [nitpick] Consider renaming '_isFirstContainer' to '_isFirstInvocation' to better reflect that it tracks the first invocation in the container; this may improve clarity for future maintainers.

private static bool _isFirstContainer = true;

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[codecov]

Codecov Report

Attention: Patch coverage is 93.75000% with 2 lines in your changes missing coverage. Please review.

Project coverage is 74.18%. Comparing base (1a8c29c) to head (6eba427).
Report is 5 commits behind head on develop.

Files with missing lines	Patch %	Lines
...Powertools.Common/Core/PowertoolsConfigurations.cs	0.00%	2 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff             @@
##           develop     #834      +/-   ##
===========================================
+ Coverage    74.15%   74.18%   +0.03%     
===========================================
  Files          210      211       +1     
  Lines         8411     8430      +19     
  Branches       909      914       +5     
===========================================
+ Hits          6237     6254      +17     
- Misses        1881     1883       +2     
  Partials       293      293              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.