# @architect/logs 中文文档

规范地址：https://npmcn.com/package/%40architect/logs/

版本：7\.0\.1
npm 元数据更新时间：2026-03-03T19:03:55.133Z
中文译文更新时间：2026-11-06T14:30:50.669Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：26.9 kB，10 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：6 个
- 首次发布：2019-07-09T14:35:56.621Z
- 最新版本发布：2025-11-29T00:47:05.072Z
- 近 30 天下载量：11474（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：69（近 12 个月 3 个）

## 中文简介

管理来自架构层提供的云函数的日志

## 安装

```sh
npm install @architect/logs
```

也可以使用：`pnpm add @architect/logs`、`yarn add @architect/logs`、`bun add @architect/logs`

## README

# `@architect/logs` [![GitHub CI status](https://github.com/architect/logs/workflows/Node%20CI/badge.svg)](https://github.com/architect/logs/actions?query=workflow%3A%22Node+CI%22)

[@ architect/ 日志](https://www.npmjs.com/package/@architect/logs) 是一个可以检索和清除与 您的@ architect 函数跨越环境 .

## 安装

```
npm i @architect/logs
let logs = require('@architect/logs')
```

# API 密码

## `logs({pathToCode, verbose, destroy, production}, callback)`

以参数对象作为第一个接受以下属性的参数 :

-   `pathToCode`数字 : **所需经费** 构建函数代码相对的本地路径 到当前工作目录,即:. `src/http/get-index`
-   `verbose`: 动词超级聊天模式
-   `destroy`: 如果 truthy 会通过 [`logs.destroy`](https://npmcn.com/package/%40architect/logs/#readme-logsdestroyname-pathtocode-ts-callback)否则 读取日志通过 [`logs.read`](https://npmcn.com/package/%40architect/logs/#readme-logsreadname-pathtocode-ts-callback)
-   `production`如果真相会瞄准你的弧线项目的生产环境, 否则将默认启动

默认会 [读取](https://npmcn.com/package/%40architect/logs/#readme-logsreadname-pathtocode-ts-callback) 运行环境的日志 。 如果 `destroy` 属性是真实的,相反,日志将是 [已销毁](https://npmcn.com/package/%40architect/logs/#readme-logsdestroyname-pathtocode-ts-callback)。 。 。 .

## `logs.read({name, pathToCode, ts}, callback)`

将读取日志从 [`aws.CloudWatchLogs`](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/CloudWatchLogs.html),引用 [`getLogEvents`](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/CloudWatchLogs.html#getLogEvents-property) 用于日志检索.

以参数对象作为第一个接受以下属性的参数 :

-   `name`:云阵 `StackName` 转至 [`listStackResources`](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/CloudFormation.html#listStackResources-property) 在其中搜索函数日志 。 说明 从您的应用程序名称、 环境及具体 函数正在查询 - 运行小心 !
-   `pathToCode`数字 : **所需经费** 构建函数代码相对的本地路径 到当前工作目录,即:. `src/http/get-index`
-   `ts`: 以时间戳作为显示时间长度细节的起始时间 (即说. `Date.now()`(中文(简体) )

`callback` 如果在执行过程中出现错误,则将同时引用错误. 否则, `callback` 将毫无论据地援引.

## `logs.destroy({name, pathToCode, ts}, callback)`

将删除日志从 [`aws.CloudWatchLogs`](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/CloudWatchLogs.html),引用 [`deleteLogGroup`](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/CloudWatchLogs.html#deleteLogGroup-property)。 。 。 .

以参数对象作为第一个接受以下属性的参数 :

-   `name`:云阵 `StackName` 转至 [`listStackResources`](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/CloudFormation.html#listStackResources-property) 在其中搜索函数日志 。 说明 从您的应用程序名称、 环境及具体 函数正在查询 - 运行小心 !
-   `pathToCode`数字 : **所需经费** 构建函数代码相对的本地路径 到当前工作目录,即:. `src/http/get-index`
-   `ts`: 以时间戳作为显示时间长度细节的起始时间 (即说. `Date.now()`(中文(简体) )

`callback` 如果在执行过程中出现错误,则将同时引用错误. 否则, `callback` 将毫无论据地援引.

## 常见问题

### @architect/logs 是什么？

管理来自架构层提供的云函数的日志

### 如何安装 @architect/logs？

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

### @architect/logs 支持 TypeScript 吗？

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

### @architect/logs 支持 ESM 还是 CommonJS？

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

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

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

### @architect/logs 可以商用吗？

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

### @architect/logs 的下载量有多少？

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

### @architect/logs 还在维护吗？

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