跳转到主要内容
计量器将原始事件转换为可计费数量。它们过滤事件并应用聚合函数（计数、总和、最大值、最后值）来计算每个客户的使用情况。
计量器创建界面，显示事件名称、聚合类型和过滤选项

​
API 资源

​
创建计量器

1

基本信息

​
计量器名称
string
required
描述性名称（例如，“API 请求”，“令牌使用”）
​
事件名称
string
required
要匹配的确切事件名称（区分大小写）。示例：api.call, image.generated
2

聚合

​
聚合类型
string
required
选择事件的聚合方式：
  • 计数：事件的总数（API 调用、上传）
  • 总和：添加数值（令牌、字节）
  • 最大值：期间内的最高值（峰值用户）
  • 最后值：最近的值
​
按属性聚合
string
要聚合的元数据键（对于所有类型，除了计数是必需的）。示例：tokens, bytes, duration_ms
​
计量单位
string
required
发票的单位标签。示例：calls, tokens, GB, hours
3

过滤（可选）

事件过滤
添加条件以过滤计入的事件：
  • 与逻辑：所有条件必须匹配
  • 或逻辑：任何条件都可以匹配
比较器：等于、不等于、大于、小于、包含启用过滤，选择逻辑，添加条件，包括属性键、比较器和值。
4

创建

检查配置并单击 创建计量器。

​
查看分析

计量器分析
您的计量器仪表板显示：
  • 概述：总使用量和使用图表
  • 事件：接收到的单个事件
  • 客户：每个客户的使用情况和费用

​
故障排除

  • 事件名称必须完全匹配（区分大小写）
  • 检查计量器过滤器是否未排除事件
  • 验证客户 ID 是否存在
  • 暂时禁用过滤器进行测试
  • 验证按属性聚合是否与元数据键完全匹配
  • 使用数字，而不是字符串：tokens: 150 而不是 "150"
  • 确保所有事件中包含所需属性
  • 完全匹配大小写
  • 对于数据类型使用正确的运算符
  • 确保事件包含过滤的属性
  • 检查事件选项卡以计算实际接收到的事件
  • 验证聚合类型（计数与总和）
  • 确保值为数字以进行总和/最大值

​
下一步

发送事件

开始从您的应用程序向计量器发送使用事件。

查看蓝图

使用现成的计量器配置以满足常见用例。