# @dynatrace/oneagent 中文文档

规范地址：https://npmcn.com/package/%40dynatrace/oneagent/

版本：1\.325\.69-1\.0\.0
npm 元数据更新时间：2025-12-15T13:31:21.708Z
中文译文更新时间：2026-11-13T02:47:38.282Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40dynatrace/oneagent
原文对照：https://npmcn.com/package/%40dynatrace/oneagent/?lang=original
项目主页：https://www.dynatrace.com/technologies/nodejs-monitoring/
源码仓库：https://github.com/Dynatrace/agent-nodejs

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

- 包体积（解压后）：14.6 kB，7 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=12
- 运行依赖：2 个
- 首次发布：2016-11-17T09:59:42.426Z
- 最新版本发布：2025-12-15T13:31:21.449Z
- 近 30 天下载量：8554（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：202（近 12 个月 2 个）

## 中文简介

用于 PaaS 环境的 Dynatrace 节点 js OneAgent

## 安装

```sh
npm install @dynatrace/oneagent
```

也可以使用：`pnpm add @dynatrace/oneagent`、`yarn add @dynatrace/oneagent`、`bun add @dynatrace/oneagent`

## README

# PaaS 的 Dynatrace npm 模块

这个模块增加了PaaS环境中没有专用集成支持的Node.js的企业等级监测. 在使用此模块之前, 请 [审查 Dynatrace 文档](https://docs.dynatrace.com/docs/observe/infrastructure-monitoring/cloud-platform-monitoring) 改为 确保没有市场集成 或建设包 可供您的平台使用.

## 安装

-   [免费报名](https://www.dynatrace.com/trial/) 并遵守指示
-   点击“ 部署 Dynatrace ”
-   点击“ 设置 PaaS 集成”
-   生成 PaaS 令牌
-   运行 `$ npm install --save @dynatrace/oneagent` 在您的工程目录中
-   使用先前创建的证书在您的应用程序中添加以下代码块作为第一个声明

```js
try {
  require('@dynatrace/oneagent')({
    environmentid: '<environmentid>',
    apitoken: '<paastoken>',
    endpoint: '<endpoint url>', // specify endpoint url - not needed for SaaS customers
    rejectUnauthorized: true // default is false which allows to use a self-signed certificate, see more below
  });
} catch (err) {
  console.log('Failed to load OneAgent: ', err);
}
```

这个 `rejectUnauthorized` 选项控制 TLS 证书验证 `/v1/deployment/installer/agent/connectioninfo`。它不会对其他 OneAgent 代码模块的通信以及被监测的应用程序产生影响. 默认情况下,只针对向 Dynatrace 域提出的请求执行证书验证(例如, `dynatrace.com`) (中文(简体) ).  
对所有连接执行 TLS 证书验证并拒绝自签证书, 设置 `rejectUnauthorized: true`。 。 。 .

#### 嵌入调试输出

要启用调试输出设置 `DEBUG` 环境变量改为 `dynatrace*`。详见 [调试模块文档](https://www.npmjs.com/package/debug)。 。 。 .

## 部署

### 向AWS Lambda部署Dynatrace

从Dynatrace OneAgent 1.207开始,Dynatrace提供了一个专用的AWS Lambda层来监控以AWS Lambda为基础的节点.js功能. 请审查 [Dynatrace 产品新闻](https://www.dynatrace.com/news/blog/dynatrace-extends-distributed-tracing-for-serverless-on-aws-lambda/) 财务报告和审定财务报表 [文档](https://www.dynatrace.com/support/help/technology-support/cloud-platforms/amazon-web-services/integrations/deploy-oneagent-as-lambda-extension/) 学习更多.

### 向赫鲁库部署Dynatrace

从Dynatrace OneAgent 1.141开始,Dynatrace为赫鲁库提供专用的建设包. 请参看我们 [文档](https://www.dynatrace.com/support/help/how-to-use-dynatrace/infrastructure-monitoring/cloud-platform-monitoring/heroku-monitoring) 进一步指示.

### 将Dynatrace部署到云铸厂

从Dynatrace One Agent 1.131开始 [Cloud Foundry Node.js 建筑包 1.6.10](https://github.com/cloudfoundry/nodejs-buildpack/releases/tag/v1.6.10) Dynatrace是建筑包的一部分. 由于若干改进,使用构建包比npm模块方法更可取. 比如说, 您不再需要安装依赖 `@dynatrace/oneagent` 在您的工程目录中. 您也不再需要添加一个要求声明作为您的申请的第一个声明. 请审查 [Dynatrace 产品新闻](https://www.dynatrace.com/blog/support-for-node-js-apps-on-cloud-foundry-paas/) 财务报告和审定财务报表 [文档](https://docs.dynatrace.com/docs/observe/infrastructure-monitoring/container-platform-monitoring/cloud-foundry-monitoring) 学习更多.

## 许可证

根据麻省理工学院的许可。 详情见LICENSE文件.

## 常见问题

### @dynatrace/oneagent 是什么？

用于 PaaS 环境的 Dynatrace 节点 js OneAgent

### 如何安装 @dynatrace/oneagent？

在项目目录运行 npm install @dynatrace/oneagent，或使用 pnpm add / yarn add / bun add。

### @dynatrace/oneagent 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/dynatrace\_\_oneagent 是否存在。

### @dynatrace/oneagent 支持 ESM 还是 CommonJS？

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

### @dynatrace/oneagent 需要什么版本的 Node\.js？

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

### @dynatrace/oneagent 可以商用吗？

@dynatrace/oneagent 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @dynatrace/oneagent 的下载量有多少？

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

### @dynatrace/oneagent 还在维护吗？

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