SuperAPI AI 工具集

prometheus

通用与其它

查看项目

更新于 10-16 06:13

技能介绍

用途:该技能用于规范 Prometheus 指标埋点,强调在埋点阶段就选对指标类型、命名清晰、标签克制,避免后期迁移仪表盘、告警和记录规则。适用于任何涉及 Prometheus 指标交互的任务,包括编写埋点代码、PromQL 查询、告警与记录规则以及代码审查。

主要能力:

  1. 指标类型选择。Counter 用于单调递增、仅重启归零的值,如请求数、错误数、传输字节,API 为 inc(),命名以 _total 结尾,查询时必须用 rate() 或 increase()。Gauge 用于可升可降的值,如温度、内存、进行中请求、队列深度,API 含 inc()、dec()、set(),不可对其使用 rate()。Histogram 将观测值分桶,产生 _bucket{le}、_sum、_count,适合延迟、响应大小等分布,可跨实例聚合,桶创建后不可更改,用 histogram_quantile() 计算分位。Summary 在客户端计算流式分位,产生 {quantile}、_sum、_count,不能跨实例聚合;仅当需要精确分位、单实例、埋点时就已知分位且接受改代码加新分位时才用。默认选择 Histogram。
  2. 命名。格式为 <namespace><subsystem><name><unit><suffix>,使用 snake_case,冒号保留给记录规则,双下划线前缀保留给内部,必须带命名空间前缀,使用基本单位(秒、字节),单位用复数形式,Counter 加 _total,info 指标加 _info,时间戳加 _timestamp_seconds。
  3. 标签。用于会过滤或聚合的维度,不要放进指标名。避免无界值(用户 ID、邮箱、完整 URL)和高基数(每指标超过约 100 个唯一值)。每个唯一标签组合都是新时间序列,默认目标每指标基数低于 10。
  4. 埋点模式。在线服务关注请求速率、错误率、延迟直方图、进行中数量;离线处理按阶段记录进出、进行中、最后处理时间戳、处理时长;批处理任务推送 Pushgateway,时长用 Gauge 而非 Histogram。
  5. PromQL。Counter 先 rate() 再聚合,如 sum(rate(x[5m])),不可 rate(sum(x)[5m]);直方图聚合分位时 by 子句必须保留 le;rate() 窗口至少为抓取间隔的 4 倍。
  6. 告警与记录规则。告警针对症状而非原因;记录规则命名格式 level:metric:operations;比率需分别聚合分子分母再相除,不可对比率取平均。
  7. Exporter。目标系统不原生暴露指标时编写,指标加 exporter 前缀,每次抓取创建新指标实例,导出原始 Counter 和当前值。

使用方式:技能内含 references 目录下的 metric-types.md、naming.md、instrumentation.md、promql.md、alerting-and-rules.md、exporters.md 等参考文件,路径以 ${CLAUDE_SKILL_DIR} 开头。应用时静默遵循约定,若现有代码库与约定冲突则遵循代码库并指出一次分歧。

限制:资料未提供该技能的安装命令、收费方式、支持平台或具体版本信息。