用途:该技能面向 StatsD 指标埋点的编写与审查,帮助在代码中正确选择指标类型、规范命名,并理解 UDP 推送带来的零延迟与静默出错风险。
主要能力:提供指标类型决策依据——计数器(|c)衡量事件发生速率,仪表(|g)记录瞬时值,计时器(|ms)记录毫秒耗时,直方图(|h)记录数值分布,集合(|s)统计每周期唯一值数,Distribution(|d)仅 DogStatsD 支持、用于跨主机全局分布。同时覆盖采样与采样校正、命名规则、标签、聚合与 flush、客户端模式以及后端选择。
命名与标签:建议格式为 <namespace>.<subsystem>.<target>.<metric>.<unit>,例如 myapp.api.request.duration.ms;始终按服务名加命名空间、使用点分隔层级、包含单位、全部小写、段内用下划线、避免连字符。维度尽量放在标签中而非名称里,标签用逗号分隔且不含空格。建议统一服务标签 env、service、version,并控制标签基数,若某标签可能超过 1000 个不同取值则不宜作为标签。
使用方式:每条指标线格式为 <metric_name>:<value>|<type>[|@<sample_rate>][|#<tags>]。初始化时每个应用一个客户端实例,设置命名空间前缀与全局标签,关闭前 flush。生产环境启用客户端缓冲与 shutdown 前 flush。采样仅用于计数器和计时器,仪表和集合不可采样;高吞吐时按资料建议调整采样率或启用客户端聚合。计数器和计时器支持 |@<rate> 采样,服务器会做 1/rate 校正。
聚合与后端:默认 flush 周期 10 秒,计数器 flush 后归零,仪表在周期之间保留最后值。后端可选 Graphite、Datadog(DogStatsD)、statsd_exporter、Telegraf。
限制与注意:UDP 为 fire-and-forget,选错类型或命名不当会静默损坏数据;仪表不能在保留期间作为计数器使用,集合不能采样以免破坏唯一性统计;具体客户端版本与配置细节以实际环境为准,本技能资料未提供价格或平台支持信息。