@aws-cdk/metrics-facade-alpha

中文文档
2.275.0-alpha.0发布于 2026/10/27Apache-2.0TypeScriptCommonJS零依赖近 30 天下载 2497

用于度量衡外观的 CDK 构造库

中文使用文档
文档目录4 节
  1. 云表计量
  2. 资源范围计量
  3. 未瞄准的计量
  4. 可用计量

方程式阿尔法图书馆


cdk-constructs: Experimental

本单元中更高层次的构件的API是实验性的并正在积极开发中. 在今后任何版本中,它们都须作非背向相容的修改或去除。 这些是 不适用 语义版本 模型和断开的更改 在发行笔记中宣布. 这意味着虽然你可能使用它们,但可能需要更新 当更新到此软件包的更新版本时,您的源代码.


云表计量

此库会自动生成为 AWS 资源输入的 Cloud Watch 度量助手 。 这些衡量标准有两种口味: 资源范围d 财务报告和审定财务报表 未覆盖。 。 。 .

资源范围计量

资源范围度量衡是通过资源参考(如Lambda函数)创建的. 资源维度是自动注入的,因此,计量方法返回已经过滤到该特定资源的计量.

度量衡基本用途

import * as lambda from 'aws-cdk-lib/aws-lambda';
import * as cloudwatch from 'aws-cdk-lib/aws-cloudwatch';
import { LambdaMetrics } from '@aws-cdk/metrics-facade-alpha/aws-lambda';

// Works with L2 constructs
declare const fn: lambda.Function;
const fnMetrics = LambdaMetrics.fromFunction(fn);

new cloudwatch.Alarm(scope, 'ErrorAlarm', {
  metric: fnMetrics.errors(),
  threshold: 5,
  evaluationPeriods: 1,
  comparisonOperator: cloudwatch.ComparisonOperator.GREATER_THAN_THRESHOLD,
});

// Also works with L1 constructs
declare const cfnFunction: lambda.CfnFunction;
const cfnMetrics = LambdaMetrics.fromFunction(cfnFunction);

计量特性

import * as lambda from 'aws-cdk-lib/aws-lambda';
import { LambdaMetrics } from '@aws-cdk/metrics-facade-alpha/aws-lambda';

declare const fn: lambda.Function;
const fnMetrics = LambdaMetrics.fromFunction(fn);

// FunctionName dimension is automatically injected from the function reference
const metric = fnMetrics.invocations();

统计重叠: 通过 MetricOptions

import * as lambda from 'aws-cdk-lib/aws-lambda';
import { LambdaMetrics } from '@aws-cdk/metrics-facade-alpha/aws-lambda';

declare const fn: lambda.Function;
const fnMetrics = LambdaMetrics.fromFunction(fn);

// Default statistic for Duration is Average
const defaultMetric = fnMetrics.duration();

// Override statistic via MetricOptions
const p99Metric = fnMetrics.duration({ statistic: 'p99' });

未瞄准的计量

未瞄准的度量衡不与特定资源相绑定. 它们可以有明确的维度,也可以没有全账户的维度.

未瞄准的量子基本使用

import { LambdaMetrics } from '@aws-cdk/metrics-facade-alpha/aws-lambda';
import * as cloudwatch from 'aws-cdk-lib/aws-cloudwatch';

// Explicit dimensions
const fnMetrics = new LambdaMetrics.FunctionMetrics({
  functionName: 'my-function',
});
fnMetrics.errors();

// Per-resource dimensions (e.g. alias or version)
const resourceMetrics = new LambdaMetrics.ResourceMetrics({
  functionName: 'my-function',
  resource: 'prod',
});
resourceMetrics.provisionedConcurrencyUtilization();

// Account-wide metrics (no dimensions)
const accountMetrics = new LambdaMetrics.AccountMetrics();
accountMetrics.concurrentExecutions();
accountMetrics.unreservedConcurrentExecutions();

可用计量

度量衡来自AWS Cloud Watch 度量衡光谱数据库. 常见的例子:

羊肉计量法数字 :

  • invocations() - 函数引用计数
  • errors() - 函数错误计数
  • duration() - 职能执行期限
  • throttles() - 函数节流阀计数
  • concurrentExecutions() - 同时执行数

从服务特定模块导入衡量标准:

import { LambdaMetrics } from '@aws-cdk/metrics-facade-alpha/aws-lambda';

版本与发布记录

@aws-cdk/metrics-facade-alpha 共发布 17 个版本,首次发布于 2026/07/03;过去 12 个月发布了 17 个版本。

版本发布日期距今
2.275.0-alpha.0latest2026/10/2712 天前
2.274.0-alpha.02026/10/2018 天前
2.273.0-alpha.02026/10/0930 天前
2.272.0-alpha.02026/09/301 个月前
2.271.0-alpha.02026/09/261 个月前
2.270.0-alpha.02026/09/181 个月前

关于 @aws-cdk/metrics-facade-alpha 的常见问题

@aws-cdk/metrics-facade-alpha 是什么?

用于度量衡外观的 CDK 构造库

如何安装 @aws-cdk/metrics-facade-alpha?

在项目目录运行 npm install @aws-cdk/metrics-facade-alpha,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:constructs(^10.5.0)、aws-cdk-lib(^2.275.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@aws-cdk/metrics-facade-alpha 支持 TypeScript 吗?

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

@aws-cdk/metrics-facade-alpha 支持 ESM 还是 CommonJS?

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

@aws-cdk/metrics-facade-alpha 需要什么版本的 Node.js?

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

@aws-cdk/metrics-facade-alpha 可以商用吗?

@aws-cdk/metrics-facade-alpha 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@aws-cdk/metrics-facade-alpha 的下载量有多少?

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

@aws-cdk/metrics-facade-alpha 还在维护吗?

最新版本 2.275.0-alpha.0 发布于 2026/10/27(12 天前);至今共发布 17 个版本,其中过去 12 个月发布了 17 个;首次发布于 2026/07/03。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。