Skip to content

Commit a902661

Browse files
[SVLS-7874] update documentaiton for serverless deployment tracking (#32928)
* [SVLS-7874] update documentaiton for serverless deployment tracking * Update content/en/serverless/aws_lambda/deployment_tracking.md Co-authored-by: Joe Peeples <[email protected]> --------- Co-authored-by: Joe Peeples <[email protected]>
1 parent 90d738d commit a902661

File tree

2 files changed

+18
-6
lines changed

2 files changed

+18
-6
lines changed

content/en/serverless/aws_lambda/deployment_tracking.md

Lines changed: 18 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -13,13 +13,13 @@ aliases:
1313

1414
Deployment tracking helps you to understand when a new version of code or a configuration change causes a spike in errors, degraded performance, or when your cloud environment drifts from its expected state.
1515

16-
To access deployment tracking for your serverless applications, select a function in the [Serverless view][1] to open a side panel, and click the **Deployments** tab. This shows key serverless metrics like invocations, execution duration, and error counts automatically displayed with event overlays that mark code deployments and configuration changes related to the function.
16+
## Deployment Events
1717

18-
For visibility into historical code and configuration changes, adjust the global time selector at the top right of the view.
18+
Datadog collects code and configuration change events for your AWS Lambda functions from AWS CloudTrail.
1919

20-
## Setup
20+
To see deployment events for your serverless applications, select a function in the [Serverless view][1] to open a side panel, and click the **Deployments** tab.
2121

22-
Datadog collects code and configuration change events for your AWS Lambda functions from AWS CloudTrail.
22+
### Setup
2323

2424
1. If you haven't already, set up the [Amazon Web Services][2] integration.
2525

@@ -33,7 +33,7 @@ If you have already added the permission, but you still don't see events for any
3333

3434
{{< img src="serverless/lambda_integration_settings.png" alt="Lambda Integration Settings" style="width:100%;">}}
3535

36-
### Resource Changes
36+
## Resource Changes
3737

3838
<div class="alert alert-info">Resource Changes is in Preview. Enabling resource collection can impact your AWS CloudWatch costs.</div>
3939

@@ -45,6 +45,17 @@ You can use [Resource Changes][4] for visibility and control over configuration
4545

4646
See the [Resource Changes][4] documentation for more information.
4747

48+
## Tag telemetry with deployment information
49+
50+
Datadog can group your metrics by tags such as `git.commit.sha` to correlate code changes with issues.
51+
52+
{{< img src="serverless/metrics_grouped_by_git_commit.png" alt="Metrics Grouped By Git Commit" style="width:100%;">}}
53+
54+
Depending on your configuration, the Datadog Lambda Extension adds the following tags to your metrics, logs, and traces:
55+
- `executed_version`: The AWS Lambda function version that was executed. This tag is added by the Datadog Lambda Extension when you enable [AWS Lambda versioning][6] for your function. To use this feature, you must publish versions of your Lambda function and configure aliases or direct invocations to use specific versions.
56+
- `version`: The deployment version tag set through the `DD_VERSION` Lambda environment variable. If you have this as an environment variable, it is added as a tag by the Datadog Lambda Extension.
57+
- `git.commit.sha`: The Git commit hash associated with the deployed code. This must be included in the `DD_TAGS` Lambda environment variable (for example, `DD_TAGS=git.commit.sha:abc123def456`). If you deploy your Lambda function using Datadog's CI or CDK construct, this tag is automatically added to the `DD_TAGS` environment variable during deployment. Otherwise, you must add it to `DD_TAGS` yourself.
58+
4859
## Further Reading
4960

5061
{{< partial name="whats-next/whats-next.html" >}}
@@ -53,4 +64,5 @@ See the [Resource Changes][4] documentation for more information.
5364
[2]: /integrations/amazon_web_services/#setup
5465
[3]: https://app.datadoghq.com/integrations/amazon-lambda
5566
[4]: /infrastructure/resource_catalog/resource_changes/
56-
[5]: https://app.datadoghq.com/integrations/amazon-web-services
67+
[5]: https://app.datadoghq.com/integrations/amazon-web-services
68+
[6]: https://docs.aws.amazon.com/lambda/latest/dg/configuration-versions.html
50.7 KB
Loading

0 commit comments

Comments
 (0)