无服务器- dash0
无服务器框架插件, 自动添加 达什 0 Lambda 扩展层和功能的环境变量.
兼容无服务器框架 v3和 v4 .
安装
npm install --save-dev @dash0/serverless-dash0
使用量
将插件添加到您的 serverless.yml 并配置 custom.dash0 节:
哪里能找到你的终点: 在Dash0应用程序中,去 设置 → 终点 → 通过 HTTP OTLP ,然后从 终点 字段.
plugins:
- "@dash0/serverless-dash0"
custom:
dash0:
endpoint: https://ingress.<your-environment>.dash0.com:4318 # e.g. https://ingress.eu-west-1.aws.dash0.com:4318
token: ${env:DASH0_TOKEN}
layerVersion: latest
functions:
myFunction:
handler: handler.hello
runtime: nodejs20.x
dash0-traced: true
untracedFunction:
handler: handler.other
runtime: nodejs20.x
只有函数 dash0-traced: true 将添加 Dash0 层和环境变量。 所有其他功能都未受影响.
支持的运行时间
| 运行时间 | 层 |
|---|---|
nodejs* | dash0-extension-node |
python* | dash0-extension-python |
java* | dash0-extension-java |
容器映像功能( E)image 改为 handler)不支持。 使用 Dash0 多克图像 换句话说.
配置参考
所有选项都设置在 custom.dash0 在你身边 serverless.yml。 。 。 .
需求
| 选项 | 类型 | 说明 |
|---|---|---|
endpoint | string | Dash0 OTLP摄取端点. 在Dash0的应用程序下找到它 设置 → 终点 → 通过 HTTP OTLP → 终点。 。 。 . |
layerVersion | number 或者说 "latest" | 要使用的图层版本 。 特定版本编号,或 "latest" 以使用与插件捆绑的版本. |
token | string | Dash0 API 代币. 要求,除非 tokenSecretArn 提供. |
tokenSecretArn | string | 一个包含 Dash0 API 令牌的 AWS 机密管理器的 ARN 。 要求,除非 token 提供。 如果两者均被设定,则将添加两个环境变量. |
可选
| 选项 | 类型 | 默认 | 信封 var 套装 | 说明 |
|---|---|---|---|---|
tokenSecretKey | string | - 说吧 | DASH0_TOKEN_SECRET_KEY | JSON密钥从密钥中取出令牌(当密值为JSON对象). |
dataset | string | - 说吧 | DASH0_DATASET | 路由遥测到特定的 Dash0 数据集. |
extensionLogLevel | string | warn | DASH0_EXTENSION_LOG_LEVEL | 扩展的日志级别 。 其中一个: trace, (中文(简体) ), debug, (中文(简体) ), info, (中文(简体) ), warn, (中文(简体) ), error。 。 。 . |
disableAutoInstrumentation | boolean | false | DASH0_DISABLE_AUTO_INSTRUMENTATION | 禁用自动仪器 。 扩展仍然会产生合成的跨度. |
sendOnInvocationEnd | boolean | true | DASH0_SEND_ON_INVOCATION_END | 在当前引用结尾处发送遥测而不是下一个开头. |
disableTelemetryLogCollection | boolean | false | DASH0_DISABLE_TELEMETRY_LOG_COLLECTION | 禁用 Lambda 遥测 API 日志收集 . |
disableTelemetryMetrics | boolean | false | DASH0_DISABLE_TELEMETRY_METRICS | 禁止排放补充FaaS指标. |
disableTelemetryTraces | boolean | false | DASH0_DISABLE_TELEMETRY_TRACES | 禁用自动仪器和合成相间(包括出错路径跟踪). |
createPayloadLogRecords | boolean | true | DASH0_CREATE_PAYLOAD_LOG_RECORDS | 为请求/答复有效载荷创建日志记录. |
requestTimeout | number | 2000 | DASH0_REQUEST_TIMEOUT | HTTP 请求以毫秒计的超时 . |
xrayTracesEnabled | boolean | false | DASH0_XRAY_TRACES_ENABLED | 保留 X-Ray 跟踪上下文. |
maskRules | string | - 说吧 | DASH0_MASK_RULES | 用于掩盖敏感数据的JSON阵列正则克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克. |
maskEnvVars | string | - 说吧 | DASH0_MASK_ENV_VARS | 用于掩盖环境可变值的 JSON 阵列正则克力克图案. |
行为
- 插件运行在
before:package:initialize寿命轮钩. - 现有函数层被保留; Dash0 层被附加.
- 现有的函数环境变量永远不会被覆盖. 如果你准备好了
DASH0_EXTENSION_LOG_LEVEL中,插件不会被全局值所取代. - 没有支持的运行时间或容器图像的函数会用警告跳过 .