跳转到主要内容

Datadog AWS Lambda库

项目描述

datadog-lambda-python

build PyPI PyPI - Python Version Slack License

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负载结构的嵌套深度。一旦达到指定的最大深度,则将标签的值设置为超出此级别的任何嵌套元素的字符串化值。
例如,给定输入负载
{
"lv1" : {
"lv2": {
"lv3": "val"
}
}
}
如果深度设置为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_idtrace_id以及serviceenv的字典。

贡献

如果您在此包中发现问题并有修复方案,请随时根据程序提交拉取请求。

社区

有关产品反馈和问题,请加入Datadog社区Slack中的#serverless频道。

许可证

除非另有声明,否则本存储库中所有文件均受Apache License Version 2.0许可。

本产品包含在Datadog(https://www.datadoghq.com/)开发的软件。版权所有2019 Datadog, Inc.

项目详情


发布历史 发布通知 | RSS源

下载文件

下载适用于您平台的文件。如果您不确定选择哪个,请了解有关安装包的更多信息。

源代码发行版

datadog_lambda-6.99.0.tar.gz (40.7 kB 查看哈希值)

上传时间 源代码

编译发行版

datadog_lambda-6.99.0-py3-none-any.whl (47.2 kB 查看哈希值)

上传时间 Python 3

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF 赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误日志 StatusPage StatusPage 状态页面