# @alicloud/log 中文文档

规范地址：https://npmcn.com/package/%40alicloud/log/

版本：1\.2\.6
npm 元数据更新时间：2025-12-16T09:59:41.535Z
中文译文更新时间：2026-11-05T18:31:33.853Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：15.8 kB，5 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：4 个
- 首次发布：2017-08-31T07:07:49.206Z
- 最新版本发布：2025-12-16T09:59:41.315Z
- 近 30 天下载量：65940（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 1 个）

## 中文简介

阿里云日志服务节点.js SDK

## 安装

```sh
npm install @alicloud/log
```

也可以使用：`pnpm add @alicloud/log`、`yarn add @alicloud/log`、`bun add @alicloud/log`

## README

# 整合测试

1.  创建测试项目
2.  在该工程下创建两个测试商店, 一个配置了索引

-   第一个( 不配置日志索引) 将用来测试索引 CRUD
-   第二个( 配置了日志索引) 将用来测试日志检索

3.  运行

```
ACCESS_KEY_ID=<key> ACCESS_KEY_SECRET=<secret> TEST_PROJECT=<project you have created> TEST_STORE=<test store without index> TEST_STORE2=<test store with index> make test
```

## 输入客户端

### 使用永久访问密钥

使用区域

```javaScript
const client = new Client({
  accessKeyId: "your_access_key_id",
  accessKeySecret: "your_access_key_secret",
  region: 'cn-hangzhou'
});
```

或使用终点

```javaScript
const client = new Client({
  accessKeyId: "your_access_key_id",
  accessKeySecret: "your_access_key_secret",
  endpoint: 'cn-hangzhou.log.aliyuncs.com'
});
```

### 使用证书提供者

全权证书提供商为从外部来源获取全权证书提供了更方便和安全的途径。 您可以从您的服务器或其他 Alibaba Cloud 服务中获取这些证书, 并定期旋转它们 .

```javaScript
const yourCredentialsProvider = new YourCredentialsProvider();
const client = new Client({
  credentialsProvider: yourCredentialsProvider,
  region: 'cn-hangzhou'
});
```

证明书必须由您执行 必须是有财产命名的物体 `getCredentials`,以及 `getCredentials` 是返回证书对象的可调用函数/方法.

返回的证书对象来自 `getCredentials` 不得是无效或未定义的,并具有命名属性 `accessKeyId`, (中文(简体) ), `accessKeySecret` 财务报告和审定财务报表 `securityToken`。 。 。 .

以下是证书的简单例子:

```javaScript
class YourCredentialsProvider {
  constructor() {
    this.credentials = {
      accessKeyId: "your_access_key_id",
      accessKeySecret: "your_access_key_secret",
      securityToken: "your_security_token"
    };
  }
  // The method getCredentials is called by client to get credentials for signing and authentication.
  // Caching and refreshing logic is required in your implementation for performance.
  async getCredentials() {
    return this.credentials;
  }
}
```

## 常见问题

### @alicloud/log 是什么？

阿里云日志服务节点\.js SDK

### 如何安装 @alicloud/log？

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

### @alicloud/log 支持 TypeScript 吗？

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

### @alicloud/log 支持 ESM 还是 CommonJS？

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

### @alicloud/log 可以商用吗？

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

### @alicloud/log 的下载量有多少？

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

### @alicloud/log 还在维护吗？

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