# @dash0/serverless-dash0 中文文档

规范地址：https://npmcn.com/package/%40dash0/serverless-dash0/

版本：1\.0\.9
npm 元数据更新时间：2026-11-09T09:21:17.116Z
中文译文更新时间：2026-11-11T12:22:46.149Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40dash0/serverless-dash0
原文对照：https://npmcn.com/package/%40dash0/serverless-dash0/?lang=original
项目主页：https://github.com/dash0hq/dash0-lambda-extension#readme
源码仓库：https://github.com/dash0hq/dash0-lambda-extension

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：16.1 kB，13 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=16\.0\.0
- 运行依赖：0 个
- peer 依赖：serverless \>=3\.0\.0
- 首次发布：2026-04-27T11:26:59.355Z
- 最新版本发布：2026-11-09T09:21:16.616Z
- 近 30 天下载量：254568（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

自动添加 Dash0 Lambda 跟踪层和配置的无服务器框架插件

## 安装

```sh
npm install @dash0/serverless-dash0
```

也可以使用：`pnpm add @dash0/serverless-dash0`、`yarn add @dash0/serverless-dash0`、`bun add @dash0/serverless-dash0`

## README

# 无服务器- dash0

无服务器框架插件, 自动添加 [达什 0](https://www.dash0.com/) Lambda 扩展层和功能的环境变量.

兼容无服务器框架 v3和 v4 .

## 安装

```bash
npm install --save-dev @dash0/serverless-dash0
```

## 使用量

将插件添加到您的 `serverless.yml` 并配置 `custom.dash0` 节:

> **哪里能找到你的终点:** 在Dash0应用程序中,去 **设置 → 终点 → 通过 HTTP OTLP** ,然后从 **终点** 字段.

```yaml
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 多克图像](https://github.com/dash0hq/dash0-lambda-extension#docker) 换句话说.

## 配置参考

所有选项都设置在 `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` 中,插件不会被全局值所取代.
-   没有支持的运行时间或容器图像的函数会用警告跳过 .

## 常见问题

### @dash0/serverless-dash0 是什么？

自动添加 Dash0 Lambda 跟踪层和配置的无服务器框架插件

### 如何安装 @dash0/serverless-dash0？

在项目目录运行 npm install @dash0/serverless-dash0，或使用 pnpm add / yarn add / bun add。

### @dash0/serverless-dash0 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @dash0/serverless-dash0 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @dash0/serverless-dash0 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=16\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @dash0/serverless-dash0 可以商用吗？

@dash0/serverless-dash0 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @dash0/serverless-dash0 的下载量有多少？

根据 npm 官方下载统计，@dash0/serverless-dash0 在 2026/10/12 – 2026/11/10 这 30 天内被下载 254,568 次，日均约 8,486 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @dash0/serverless-dash0 还在维护吗？

最新版本 1\.0\.9 发布于 2026/11/09（2 天前）；至今共发布 10 个版本，其中过去 12 个月发布了 10 个；首次发布于 2026/04/27。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。