# @davstack/logs-server 中文文档

规范地址：https://npmcn.com/package/%40davstack/logs-server/

版本：2\.10\.0
npm 元数据更新时间：2026-06-06T13:00:53.088Z
中文译文更新时间：2026-11-11T16:21:42.191Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40davstack/logs-server
原文对照：https://npmcn.com/package/%40davstack/logs-server/?lang=original

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

- 包体积（解压后）：349 kB，17 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：1 个
- 首次发布：2026-05-25T20:39:41.464Z
- 最新版本发布：2026-06-06T13:00:52.957Z
- 近 30 天下载量：13503（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 22 个）

## 中文简介

局部哨兵形遥测槽(logs + track):在HTTP上吞入信封,坚持每发雷波SQLite. 用 sqlite3 读取到日志表( kkins 区分日志对相间; 平坦的原子列) .

## 安装

```sh
npm install @davstack/logs-server
```

也可以使用：`pnpm add @davstack/logs-server`、`yarn add @davstack/logs-server`、`bun add @davstack/logs-server`

## README

# @davstack/logs-服务器

局部哨兵形状的app - > sqlite 遥测槽(logs) **财务报告和审定财务报表** 追踪.

## 为什么

-   **E2E可追溯性.** 前端+后端+工人 POST 到相同的 `.davstack/logs/default.db`· ; `trace_id` 跟踪各种服务的要求。 日志、跟踪跨度和错误事件位于一个表格中,受到歧视 `kind` 栏(`'log' | 'span' | 'event'`) (中文(简体) ).
-   **下正显.** 将自动设备和低功耗设置纳入现有的哨兵记录器客户端。 设定 `tracesSampleRate` 并跨入与原木相同的水槽——没有额外的接线.
-   **为特工优化.** 默认情况下压缩一行一行——编码代理读取时没有分组通行证.

## 安装设置(1分) (S)

1.  建议:脚手架 [达夫斯达克 init](https://npmcn.com/package/%40davstack/init/README.md)

```bash
pnpx @davstack/init
```

(cd) 您的项目 repo 优先 - 日志服务器范围为代码库)

2.  在 Dev 中设置本地水槽, 将您现有的 Sentry DSN 指向守护进程 :

```ts
Sentry.init({dsn: IS_DEV ? "http://public@127.0.0.1:5181/1" : import.meta.env.VITE_SENTRY_DSN })
```

(在使用前请参看完整的设置指南 : [设置( m)](https://npmcn.com/package/%40davstack/logs-server/docs/setup.md)(中文(简体) )

## 用法示例

1.  启动服务器

```bash
davstack start
```

(更多信息: [达夫斯塔克图伊](https://npmcn.com/package/%40davstack/tui/README.md)(中文(简体) )

2.  在app中添加日志,或者使用自定义.

```ts
logger.debug("user clicked save", { user_id: 42, run_id: "r-99" })
```

(更多信息: [撰写-logs.md](https://npmcn.com/package/%40davstack/logs-server/docs/writing-logs.md)(中文(简体) )

3.  用 -- db( 可选的) 运行重播, 将本会话的日志覆盖到自己的 DB

```bash
vitest-server run --db=reorder-bug src/reorder.test.ts   # → .davstack/logs/reorder-bug.db (default: default.db)
```

注释 :

-   建议Davstack跑道员([虚拟服务器](https://npmcn.com/package/%40davstack/vitest-server/README.md)),但经常 `pnpm dev` 仍然抓取日志
-   `--db` 建议使用,但如果不使用,则在 `default.db`。 。 。 .

(更多信息: [发报机 -- -- 微波](https://npmcn.com/package/%40davstack/logs-server/docs/transmitter-wiring.md)(中文(简体) )

4.  查询日志 `sqlite3`。 。 。 .

```bash
sqlite3 -header -column .davstack/logs/default.db "
  SELECT ts, msg, attrs->>'user_id' AS user_id
  FROM logs
  WHERE data->>'body' LIKE '%clicked save%'
  ORDER BY ts;
"
```

结果 :

```
ts          msg                user_id
----------  -----------------  -------
1716480923  user clicked save  42
```

5.  查询追踪跨度 - `kind='span'` 排有真实的 `duration_ms` 因此,最慢的跨度排序为平面 SQL. `op`编号 :`status`编号 :`parent_span_id` 被平整为 `attrs`。 。 。 .

```bash
sqlite3 -header -column .davstack/logs/default.db "
  SELECT msg, duration_ms,
         attrs->>'op'     AS op,
         attrs->>'status' AS status
  FROM logs
  WHERE kind = 'span'
  ORDER BY duration_ms DESC
  LIMIT 10;
"
```

(记录和跨度共享 `trace_id` 列,所以一个 `WHERE trace_id = ?` 将全部请求时限切开。 )

6.  查询出错事件 - `kind='event'` 行是真正的例外(`Sentry.captureException`,未处理错误,反应错误边界)。 整个堆栈在 `data`· ; `exception_type`编号 :`mechanism` 被平整为 `attrs`。 。 。 .

```bash
sqlite3 -header -column .davstack/logs/default.db "
  SELECT ts, msg,
         attrs->>'exception_type' AS type,
         attrs->>'function'       AS fn,
         attrs->>'filename'       AS file
  FROM logs
  WHERE kind = 'event'
  ORDER BY ts DESC
  LIMIT 10;
"
```

## 司马

一个 `logs` 表格/会话 DB。 密钥列 :

| 栏 | 日志 | 间距( r)`kind='span'`(中文(简体) ) | 活动(`kind='event'`(中文(简体) ) |
| --- | --- | --- | --- |
| `kind` | `'log'` | `'span'` | `'event'` |
| `ts` | 日志 `timestamp` | 间距 `start_timestamp` | 事件 `timestamp` |
| `duration_ms` | `NULL` | `(timestamp - start_timestamp) * 1000` | `NULL` |
| `msg` | 日志 `body` | 间距 `description` || `op` (根:tx名称) | `"{type}: {value}"` (预算外) `message` |
| `level` | OTel 级别 | `''` | 事件 `level` (错误/致命/警告/信息) |
| `data` | 逐字记录项目 | 逐字记录/ 交易跟踪对象 | 逐字记录活动 `exception`编号 :`stacktrace`(中文(简体) ) |
| `attrs` | 平面( 未包装) | 平面跨度数据+ `op`编号 :`status`编号 :`parent_span_id`编号 :`description`编号 :`duration_ms` | `exception_type`编号 :`mechanism`编号 :`handled` + 顶端 `in_app` 边框 |

交易事件会扩展为每行一行: root( 从 `contexts.trace`+每架1辆 `spans[]` 孩子们 错误/消息事件( E)`Sentry.captureException`, (中文(简体) ), `captureMessage`,未处理错误,反应错误边界)成为一个 `kind='event'` 排行——完整堆栈在 `data`,以及 `trace_id` 将其与同一请求的日志/相干.

## 文档

-   [文件/设置](https://npmcn.com/package/%40davstack/logs-server/docs/setup.md) – 配置文件, env vars, 运行时间选择
-   [文件/书面-日志.md](https://npmcn.com/package/%40davstack/logs-server/docs/writing-logs.md) ——每台SDK发射机设置
-   [文件/阅读-日志.md](https://npmcn.com/package/%40davstack/logs-server/docs/reading-logs.md) - 平地计程车 `attrs` 和已准备好的食谱
-   [文档/收发器 -- -- md](https://npmcn.com/package/%40davstack/logs-server/docs/transmitter-wiring.md) ——通过 `davstack-logs.db` 属性
-   [文件/会议视图.md](https://npmcn.com/package/%40davstack/logs-server/docs/session-views.md) ——每个 DB SQL 视图,多 DB 路由的高值后续

## 常见问题

### @davstack/logs-server 是什么？

局部哨兵形遥测槽\(logs \+ track\):在HTTP上吞入信封,坚持每发雷波SQLite\. 用 sqlite3 读取到日志表\( kkins 区分日志对相间; 平坦的原子列\) \.

### 如何安装 @davstack/logs-server？

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

### @davstack/logs-server 支持 TypeScript 吗？

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

### @davstack/logs-server 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @davstack/logs-server 需要什么版本的 Node\.js？

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

### @davstack/logs-server 可以商用吗？

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

### @davstack/logs-server 的下载量有多少？

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

### @davstack/logs-server 还在维护吗？

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