# @aidra/pmx-io 中文文档

规范地址：https://npmcn.com/package/%40aidra/pmx-io/

版本：9\.24\.0
npm 元数据更新时间：2026-11-04T11:42:03.668Z
中文译文更新时间：2026-11-07T00:16:53.525Z
软件包许可：UNLICENSED

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

原始 npm 页面：https://www.npmjs.com/package/%40aidra/pmx-io
原文对照：https://npmcn.com/package/%40aidra/pmx-io/?lang=original
项目主页：https://github.com/westonpark/pmx#readme
源码仓库：https://github.com/westonpark/pmx

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

- 包体积（解压后）：601 kB，68 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-10-29T09:49:19.809Z
- 最新版本发布：2026-11-04T11:42:03.432Z
- 近 30 天下载量：2118（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：13（近 12 个月 13 个）

## 中文简介

由 pmx 运行的 Node.js 和 Bun apps 的处理中仪器, 或向 prodman 单独报告( @ pm2/io 兼容)

## 安装

```sh
npm install @aidra/pmx-io
```

也可以使用：`pnpm add @aidra/pmx-io`、`yarn add @aidra/pmx-io`、`bun add @aidra/pmx-io`

## README

# @aidra/pmx-io (英语)

向 Node.js 和 Bun 应用程序汇报的处理中仪器 [职业选手](https://github.com/westonpark/prodman): 衡量标准、习惯行动、例外、事件、, 记录、CPU和堆积剖面分析,以及有数据库和信件经纪人的分布式追踪 一体化。 它会保持 `@pm2/io` API,所以PM2.io的代码没有改变.

-   **按 pmx 运行 :** pmx 将这个库注入它开始的每个应用程序; 没有要安装的 。 一个 安装的复制件保持闲置 `require` 返回已插入实例.
-   **运行于 PM2 / pm2 prodman :** 通过 PM2 守护进程报告 `@pm2/io`。 。 。 .
-   **独立** (集装箱) `node app.js`,一个ECS任务,一个工人:连接到Prodman 本身是一个单一进程代理.

节点.js 18或更后,或Bun 1.1或更后. 无相依相.

## 安装

```sh
npm install @aidra/pmx-io
```

需要的代码 `@pm2/io` 可以继续这样做:以该名称安装软件包.

```sh
npm install @pm2/io@npm:@aidra/pmx-io
```

## 独立模式

设置桶键( prodman ): _Bucket 设置 – 连接服务器_)和一个应用程序名称:

```sh
PRODMAN_URL=https://prodman.example.com
PM2_PUBLIC_KEY=<public key>
PM2_SECRET_KEY=<secret key>
PM2_APP_NAME=orders-api
```

然后不更改代码地加载库 :

```sh
npx pmx-io-node run -- node server.js
node --require @aidra/pmx-io/standalone server.js
NODE_OPTIONS='--import @aidra/pmx-io/standalone.mjs' node server.mjs
```

或者在应用程序中首先需要它:

```js
const io = require('@aidra/pmx-io')
io.init({ apmOptions: { sendLogs: true, application: 'shop' } })
```

设置、服务器名称、容器和故障排除: prodman 文档页面 _没有 pmx 的 Node.js 应用程序_ (单位:千美元)`/docs/node-apm`) (中文(简体) ).

## API 密码

```js
const io = require('@aidra/pmx-io')

io.metric({ name: 'Queue length' }).set(12)
io.counter({ name: 'Jobs done' }).inc()
io.action('flush cache', (reply) => reply({ ok: true }))
io.notifyError(new Error('payment failed'), { custom: { orderId } })
```

包含类型脚本声明(`index.d.ts`),一个超级集 `@pm2/io`对.

专有. 2026年迈克·沃里纳.

## 常见问题

### @aidra/pmx-io 是什么？

由 pmx 运行的 Node\.js 和 Bun apps 的处理中仪器, 或向 prodman 单独报告\( @ pm2/io 兼容\)

### 如何安装 @aidra/pmx-io？

在项目目录运行 npm install @aidra/pmx-io，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 pmx-io-node，可以用 npx pmx-io-node 直接运行。

### @aidra/pmx-io 支持 TypeScript 吗？

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

### @aidra/pmx-io 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @aidra/pmx-io 需要什么版本的 Node\.js？

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

### @aidra/pmx-io 可以商用吗？

@aidra/pmx-io 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @aidra/pmx-io 的下载量有多少？

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

### @aidra/pmx-io 还在维护吗？

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