Datadog AWS Lambda库
项目描述
datadog-lambda-python
Python(3.8、3.9、3.10、3.11和3.12)的Datadog Lambda库可以启用增强型Lambda指标、分布式跟踪和自定义指标提交,以便从AWS Lambda函数中获取。
安装
遵循安装说明,并在Datadog中查看您函数的增强型指标、跟踪和日志。
配置
遵循配置说明,以标记您的遥测数据、捕获请求数据和响应负载,从日志或跟踪中过滤或清除敏感信息等。
有关附加跟踪配置选项,请参阅Datadog跟踪客户端的官方文档。
除了dd-trace-py支持的环镜变量外,datadog-lambda-python库还添加了以下环境变量。
环境变量 | 描述 | 默认值 |
---|---|---|
DD_ENCODE_AUTHORIZER_CONTEXT | 对于Lambda授权,当设置为true 时,跟踪上下文将被编码到响应中以便传播。支持NodeJS和Python。 |
true |
DD_DECODE_AUTHORIZER_CONTEXT | 对于通过Lambda授权器授权的Lambdas,当设置为true 时,它将解析并使用编码的跟踪上下文(如果找到)。支持NodeJS和Python。 |
true |
DD_COLD_START_TRACING | 设置为false 以禁用冷启动跟踪。用于NodeJS和Python。 |
true |
DD_MIN_COLD_START_DURATION | 设置通过冷启动跟踪进行跟踪的模块加载事件的最低持续时间(以毫秒为单位)。数字。 | 3 |
DD_COLD_START_TRACE_SKIP_LIB | 可选地跳过为以下以逗号分隔的库创建冷启动跨度。有助于限制深度或跳过已知库。 | ddtrace.internal.compat,ddtrace.filters |
DD_CAPTURE_LAMBDA_PAYLOAD | 在Datadog APM跨度中捕获传入和传出的AWS Lambda负载。 | false |
DD_CAPTURE_LAMBDA_PAYLOAD_MAX_DEPTH | 确定从AWS Lambda负载中捕获的详细程度,然后将这些负载作为标签分配给aws.lambda 跨度。它指定要处理的JSON负载结构的嵌套深度。一旦达到指定的最大深度,则将标签的值设置为超出此级别的任何嵌套元素的字符串化值。例如,给定输入负载 {如果深度设置为 2 ,则结果标签的键设置为function.request.lv1.lv2 ,值设置为{\"lv3\": \"val\"} 。如果深度设置为 0 ,则结果标签的键设置为function.request ,值设置为{\"lv1\":{\"lv2\":{\"lv3\": \"val\"}}} |
10 |
待解决问题
如果您在此包中遇到错误,我们希望了解情况。在打开新问题之前,请搜索现有问题以避免重复。
打开问题时应包括Datadog Lambda库版本、Python版本以及可选的堆栈跟踪。此外,当适用时,还应包括重现步骤。
您还可以为功能请求打开一个问题。
Lambda性能分析Beta
Datadog的持续分析器现在以Beta版形式提供Python 4.62.0版本以及版本62以上的层。此可选功能通过将DD_PROFILING_ENABLED
环境变量设置为true
来启用。在Beta测试期间,分析免费提供。
连续分析器通过启动一个线程,周期性地唤醒并捕获所有运行中的Python代码(包括分析器自身)的CPU和堆快照来工作。如果您想使分析器忽略自身,请将DD_PROFILING_IGNORE_PROFILER
设置为true
。
主要版本说明
6.x / 层版本 95+
- 此版本更改了Lambda的traceID的哈希方式,如果传入的有效负载包含步骤函数上下文对象。此更改仅影响将步骤函数上下文对象注入Lambda有效负载的用户。
5.x / 层版本 86+
- AWS已废弃对Python 3.7的支持,并从本库中移除了该支持。
4.x / 层版本 61+
- AWS已废弃对Python 3.6的支持,并从本库中移除了该支持。
dd-trace
已从0.61升级到1.4,完整发布说明请参阅此处get_correlation_ids()
已更改为get_log_correlation_context()
,现在返回一个包含活动span_id
、trace_id
以及service
和env
的字典。
贡献
如果您在此包中发现问题并有修复方案,请随时根据程序提交拉取请求。
社区
有关产品反馈和问题,请加入Datadog社区Slack中的#serverless频道。
许可证
除非另有声明,否则本存储库中所有文件均受Apache License Version 2.0许可。
本产品包含在Datadog(https://www.datadoghq.com/)开发的软件。版权所有2019 Datadog, Inc.
项目详情
下载文件
下载适用于您平台的文件。如果您不确定选择哪个,请了解有关安装包的更多信息。