# @aws-lite/cloudwatch-logs 中文文档

规范地址：https://npmcn.com/package/%40aws-lite/cloudwatch-logs/

版本：0\.1\.0
npm 元数据更新时间：2026-03-06T19:09:55.779Z
中文译文更新时间：2026-11-07T15:27:25.607Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40aws-lite/cloudwatch-logs
原文对照：https://npmcn.com/package/%40aws-lite/cloudwatch-logs/?lang=original
项目主页：https://aws-lite.org/services/cloudwatch-logs
源码仓库：https://github.com/aws-lite/aws-lite

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

- 包体积（解压后）：27.5 kB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=16
- 运行依赖：0 个
- 首次发布：2023-12-24T04:58:16.318Z
- 最新版本发布：2025-01-31T18:16:41.411Z
- 近 30 天下载量：8507（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 0 个）

## 中文简介

公务 `aws-lite` 云表日志插件

## 安装

```sh
npm install @aws-lite/cloudwatch-logs
```

也可以使用：`pnpm add @aws-lite/cloudwatch-logs`、`yarn add @aws-lite/cloudwatch-logs`、`bun add @aws-lite/cloudwatch-logs`

## README

# `@aws-lite/cloudwatch-logs`

> 公务 `aws-lite` 云表日志插件

> 由下列人员维护: [@ architect](https://github.com/architect)

## 安装

```sh
npm i @aws-lite/cloudwatch-logs
```

可选安装类型 :

```sh
npm i -D @aws-lite/cloudwatch-logs-types
```

## 参考文献

[在aws-lite.org提供实例参考文件](https://aws-lite.org/services/cloudwatch-logs)

## 参考文献

[在aws-lite.org提供实例参考文件](https://aws-lite.org/services/cloudwatch-logs)

## 方法

### `DeleteLogGroup`

[Canonical AWS API API 文档](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DeleteLogGroup.html)

属性 :

-   **`logGroupName` (弦) \[须\]**
    -   日志组名称

### `DeleteLogStream`

[Canonical AWS API API 文档](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DeleteLogStream.html)

属性 :

-   **`logGroupName` (弦) \[须\]**
    -   日志组名称
-   **`logStreamName` (弦) \[须\]**
    -   日志流名称

### `DescribeLogGroups`

[Canonical AWS API API 文档](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeLogGroups.html)

属性 :

-   **`accountIdentifiers` (阵列)**
    -   要搜索的账户列表 `includeLinkedAccounts` 实值 `true`
-   **`logGroupNamePrefix` (弦声)**
    -   要匹配的前缀
-   **`logGroupNamePattern` (弦声)**
    -   匹配对大小写敏感的子字符串
-   **`nextToken` (弦声)**
    -   如果 `NextToken` 先前的答复中退回
-   **`limit` (数目)**
    -   评价和返回的最大项目数
-   **`includeLinkedAccounts` (布尔)**
    -   在列出的账户中返回日志组 `accountIdentifiers`
-   **`logGroupClass` (弦声)**
    -   日志组类设置 : `STANDARD` (支持所有云表日志特性),或 `INFREQUENT_ACCESS` (具有较低成本的地貌子集)
    -   [更详细情况( AWS)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch_Logs_Log_Classes.html)
-   **`paginate` (布尔,字符串)**
    -   启用自动结果 pagination; 使用此选项, 而不是自制个人 pagination 请求

### `DescribeLogStreams`

[Canonical AWS API API 文档](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeLogStreams.html)

属性 :

-   **`descending` (布尔)**
    -   返回结果按降序排列(如果 `true`(中文(简体) )
-   **`limit` (数目)**
    -   评价和返回的最大项目数
-   **`logGroupIdentifier` (弦声)**
    -   日志组的名称或 ARN
-   **`logGroupName` (弦声)**
    -   日志组名称
-   **`logStreamNamePrefix` (弦声)**
    -   要匹配的前缀
-   **`nextToken` (弦声)**
    -   如果 `NextToken` 先前的答复中退回
-   **`orderBy` (弦声)**
    -   按日志流名称排列结果( E)`LogStreamName`)或事件时间(`LastEventTime`(中文(简体) )
-   **`paginate` (布尔,字符串)**
    -   启用自动结果 pagination; 使用此选项, 而不是自制个人 pagination 请求

### `GetLogEvents`

[Canonical AWS API API 文档](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogEvents.html)

属性 :

-   **`endTime` (数目)**
    -   时间范围的结束, 以 epoch 毫秒计
-   **`limit` (数目)**
    -   评价和返回的最大项目数
-   **`logGroupIdentifier` (弦声)**
    -   日志组的名称或 ARN
-   **`logGroupName` (弦声)**
    -   日志组名称
-   **`logStreamName` (弦) \[须\]**
    -   日志流名称
-   **`nextToken` (弦声)**
    -   如果 `NextToken` 先前的答复中退回
-   **`startFromHead` (布尔)**
    -   首先返回最早的日志事件( E)`true`(中文(简体) )
-   **`startTime` (数目)**
    -   时间范围的开始, 以时间为单位:毫秒
-   **`unmask` (布尔)**
    -   显示所有敏感数据的日志事件字段, 并解码和可见( O)`true`(中文(简体) )
-   **`paginate` (布尔,字符串)**
    -   启用自动结果 pagination; 使用此选项, 而不是自制个人 pagination 请求

### `GetQueryResults`

[Canonical AWS API API 文档](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetQueryResults.html)

属性 :

-   **`queryId` (弦声)**
    -   查询的ID

### `StartQuery`

[Canonical AWS API API 文档](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_StartQuery.html)

属性 :

-   **`endTime` (数目)**
    -   时间范围的结束, 时间间隔秒
-   **`limit` (数目)**
    -   评价和返回的最大项目数
-   **`logGroupIdentifiers` (阵列)**
    -   要查询的日志组列表 . `StartQuery` 需要准确的其中之一 `logGroupName`, (中文(简体) ), `logGroupNames` 或者说 `logGroupIdentifiers`。 。 。 .
-   **`logGroupName` (弦声)**
    -   日志组名称
-   **`logGroupNames` (阵列)**
    -   要查询的日志组列表 . `StartQuery` 需要准确的其中之一 `logGroupName`, (中文(简体) ), `logGroupNames` 或者说 `logGroupIdentifiers`。 。 。 .
-   **`query` (弦声)**
    -   要使用的查询字符串
-   **`startTime` (数目)**
    -   时间范围的开始, 时间间隔秒

### 有待执行的方法

> 请帮忙 [打开 PR](https://github.com/aws-lite/aws-lite#authoring-aws-lite-plugins)来啊!

-   [`AssociateKmsKey`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_AssociateKmsKey.html)
-   [`CancelExportTask`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CancelExportTask.html)
-   [`CreateDelivery`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html)
-   [`CreateExportTask`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateExportTask.html)
-   [`CreateLogAnomalyDetector`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateLogAnomalyDetector.html)
-   [`CreateLogGroup`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateLogGroup.html)
-   [`CreateLogStream`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateLogStream.html)
-   [`DeleteAccountPolicy`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DeleteAccountPolicy.html)
-   [`DeleteDataProtectionPolicy`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DeleteDataProtectionPolicy.html)
-   [`DeleteDelivery`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DeleteDelivery.html)
-   [`DeleteDeliveryDestination`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DeleteDeliveryDestination.html)
-   [`DeleteDeliveryDestinationPolicy`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DeleteDeliveryDestinationPolicy.html)
-   [`DeleteDeliverySource`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DeleteDeliverySource.html)
-   [`DeleteDestination`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DeleteDestination.html)
-   [`DeleteLogAnomalyDetector`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DeleteLogAnomalyDetector.html)
-   [`DeleteMetricFilter`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DeleteMetricFilter.html)
-   [`DeleteQueryDefinition`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DeleteQueryDefinition.html)
-   [`DeleteResourcePolicy`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DeleteResourcePolicy.html)
-   [`DeleteRetentionPolicy`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DeleteRetentionPolicy.html)
-   [`DeleteSubscriptionFilter`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DeleteSubscriptionFilter.html)
-   [`DescribeAccountPolicies`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeAccountPolicies.html)
-   [`DescribeDeliveries`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeDeliveries.html)
-   [`DescribeDeliveryDestinations`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeDeliveryDestinations.html)
-   [`DescribeDeliverySources`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeDeliverySources.html)
-   [`DescribeDestinations`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeDestinations.html)
-   [`DescribeExportTasks`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeExportTasks.html)
-   [`DescribeMetricFilters`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeMetricFilters.html)
-   [`DescribeQueries`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeQueries.html)
-   [`DescribeQueryDefinitions`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeQueryDefinitions.html)
-   [`DescribeResourcePolicies`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeResourcePolicies.html)
-   [`DescribeSubscriptionFilters`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeSubscriptionFilters.html)
-   [`DisassociateKmsKey`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DisassociateKmsKey.html)
-   [`FilterLogEvents`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_FilterLogEvents.html)
-   [`GetDataProtectionPolicy`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetDataProtectionPolicy.html)
-   [`GetDelivery`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetDelivery.html)
-   [`GetDeliveryDestination`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetDeliveryDestination.html)
-   [`GetDeliveryDestinationPolicy`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetDeliveryDestinationPolicy.html)
-   [`GetDeliverySource`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetDeliverySource.html)
-   [`GetLogAnomalyDetector`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogAnomalyDetector.html)
-   [`GetLogGroupFields`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogGroupFields.html)
-   [`GetLogRecord`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogRecord.html)
-   [`ListAnomalies`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListAnomalies.html)
-   [`ListLogAnomalyDetectors`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListLogAnomalyDetectors.html)
-   [`ListTagsForResource`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListTagsForResource.html)
-   [`ListTagsLogGroup`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListTagsLogGroup.html)
-   [`PutAccountPolicy`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutAccountPolicy.html)
-   [`PutDataProtectionPolicy`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDataProtectionPolicy.html)
-   [`PutDeliveryDestination`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestination.html)
-   [`PutDeliveryDestinationPolicy`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliveryDestinationPolicy.html)
-   [`PutDeliverySource`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html)
-   [`PutDestination`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDestination.html)
-   [`PutDestinationPolicy`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDestinationPolicy.html)
-   [`PutLogEvents`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html)
-   [`PutMetricFilter`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutMetricFilter.html)
-   [`PutQueryDefinition`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutQueryDefinition.html)
-   [`PutResourcePolicy`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutResourcePolicy.html)
-   [`PutRetentionPolicy`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutRetentionPolicy.html)
-   [`PutSubscriptionFilter`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutSubscriptionFilter.html)
-   [`StartLiveTail`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_StartLiveTail.html)
-   [`StopQuery`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_StopQuery.html)
-   [`TagLogGroup`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_TagLogGroup.html)
-   [`TagResource`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_TagResource.html)
-   [`TestMetricFilter`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_TestMetricFilter.html)
-   [`UntagLogGroup`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_UntagLogGroup.html)
-   [`UntagResource`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_UntagResource.html)
-   [`UpdateAnomaly`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_UpdateAnomaly.html)
-   [`UpdateLogAnomalyDetector`](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_UpdateLogAnomalyDetector.html)

## 学多点

-   [更多关于 `aws-lite` 插件 API](https://aws-lite.org/plugin-api)
-   [学着如何促进这个和其他 `aws-lite` 插件](https://aws-lite.org/contributing)

## 常见问题

### @aws-lite/cloudwatch-logs 是什么？

公务 aws-lite 云表日志插件

### 如何安装 @aws-lite/cloudwatch-logs？

在项目目录运行 npm install @aws-lite/cloudwatch-logs，或使用 pnpm add / yarn add / bun add。

### @aws-lite/cloudwatch-logs 支持 TypeScript 吗？

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

### @aws-lite/cloudwatch-logs 支持 ESM 还是 CommonJS？

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

### @aws-lite/cloudwatch-logs 需要什么版本的 Node\.js？

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

### @aws-lite/cloudwatch-logs 可以商用吗？

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

### @aws-lite/cloudwatch-logs 的下载量有多少？

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

### @aws-lite/cloudwatch-logs 还在维护吗？

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