单位说明
适用范围
此规范可用于ONE平台所有业务场景,包括:页面展示、API查询。
ONE平台涉及指标单位场景:
- 采集指标数据点(探针采集、ETL集成)入指标中台;(用户进行指标注册时定义了上报数据的单位和数据查询时指标中台返回的单位)
- ONE平台业务方从指标中台查询数据;(指标中台应当按用户定义的返回单位来返回数据)
- ONE平台各业务方在页面展示数据;
平台标准单位定义
基本单位
| 单位类别 | 单位及换算关系 | 平台默认展示单位 |
|---|---|---|
| 时间 | 86400000000000ns=86400000000μs=86400000ms=86400s=1440min=24h(hour)=1d(day) | 所有指标数据均在注册时指定了默认展示单位,如确认数据有单位且未定义默认展示内容时,建议使用ms |
| 数据量#2为底数的指数 | 1Byte=8bit1KiB=2^10Byte=1024Byte1MiB=2^20Byte1GiB=2^30Byte1TiB=2^40Byte1PiB=2^50Byte1EiB=2^60Byte1ZiB=2^70Byte1YiB=2^80Byte | 所有指标数据均在注册时指定了默认展示单位,如确认数据有单位且未定义默认展示内容时,建议使用KiB |
| 百分比 | 100‱=10‰=1% | 所有指标数据均在注册时指定了默认展示单位,如确认数据有单位且未定义默认展示内容时,建议使用% |
| 数量 | 次个 | 按指标注册内容认定中台返回数据单位,未定义建议保持单位为空 |
| CPU | mCores(millicore) | 含义:千分之一核 |
| 无单位 | 无 | 表示数据不涉及单位,含义是“null” |
组合单位
组合单位是用基本单位以代数形式表示的单位,组合单位中的乘和除均采用数学符号,列如:用于下载速率的单位为Btye/S。
单位标准规范
- 明确ONE平台各业务场景仅可使用以定义基本单位或基本单位的组合作为数据单位,不允许使用随意创造单位;
- 平台统一维护基本单位,如平台新增指标或新增数据类型涉及新单位,可发起基本单位注册流程向单位规范注册基本单位;
- 为保证管理数据库简洁,ONE平台单位规范仅管理被使用的基本单位,其余未用到的基本单位暂不管理。
平台单位换算规范
定义平台数据精度为千分之一,并按此精度要求进行单位换算(单位换算丢失数据不能超过千分之一精度)。
例如:“1001ms”在千分之一精度要求下可换算为“1.001s”(如换算为1.00s则不满足精度要求)。
- 基本单位换算
在保持数据精度的情况下按照基本单位中定义的换算关系进行换算;
- 组合单位换算
组合单位换算时仅换算靠近数值的第一个基本单位,其余基本单位保持不变。
如:19991Byte/s=19.99KB/s,不可换算为19.99Byte/ms
平台单位展示规范
#当前ONE平台指标注册时需指定指标在平台展示的小数位数,此方式是否可去掉?由平台统一规范数据展示位数
因用户对小数值的感官强于大数值,故当数值满足换算精度要求后就应该进行换算并展示新单位。
为保证数据可读性强要求展示时:数字和单位之间加一个空格
时间类单位
- 当数据单位为时间时要求必须展示单位;
- 因大部分指标时间单位默认为ms,会向s转化,为保证数据理解一致要求必须展示单位;
- 时间单位展示时涉及单位组合展示场景,因平台需求数据精度为千分之一,故组合时需建议保持三级;
- 如1d 3h 43min,或3h 43min 34s;
- 因时间类单位的特殊性,时间类单位用组合单位时换算不会丢失精度,故时间类换算采用如下规则:
- 当单位为ms时,数据大于等于10000.00ms时向s换算,如19833.89ms=19.83s;
- 当单位为s及其它更大的时间单位时,满足换算条件即进行单位换算,如67.53s=1min 7s;
数据量
- 当数据单位为数据量要求必须展示单位;
- 因数据量大概率涉及单位转换,转化后数据差异极大故必须展示单位;
- 数据精度要求千分之一,故建议当数据位数大于等于5位(不含小数位)时进行单位换算;
- 列如:9999MB无需换算,10009MB需换算位10.00GB;
- 数据量最大单位为PB,当数据换算为PB后仍然是一个大数时建议进行简写,提高数据可读性;
- 中文环境
- 大数标准:数据位数大于等于5位;
- 换算原则:当判断数据为大数时,保留两位小数,换算为“xx.xx万”、“xx.xx亿”、““xx.xx万亿”(如极限情况下数据超过万亿则不再进行简写换算)
- 示例:19876.78 PB=1.98万 PB;14749.99万 PB=1.47亿 PB
- 英文环境
- 大数标准:数据位数大于等于4位
- 换算元数据:当判断数据为大数时,将数据转成保留两位小数并用K、M、G进行表示
- 值 < 1,000 → 原值,保留2位小数,如 999.83
- 1,000 ≤ 值 < 1,000,000 → 除以 1,000,追加 K,如 12.34K
- 1,000,000 ≤ 值 < 10^9 → 除以 1,000,000,追加 M,如 5.67M
- 值 ≥ 10^9 → 除以 10^9,追加 G,如 1.23G
- 中文环境
百分比
- 但数据范围为%时必须展示单位;
- 百分数为特殊类型数值,如不展示单位无法确认数据含义;
- 百分比最大单位为%,当数据换算为%后仍然是一个大数时建议进行简写,提高数据可读性;
- 中英文环境大数标准及简写原则和数据量单位中原则保持一致。
数量及无单位
- 因数量相关指标起名称具有很强的指向性(如:用户数、错误次数、调用链数等),故明确如场景无特殊展示要求,忽略数据的数量类单位;(与无单位处理方式类似)
- 当数据无单位时直接展示数值,当数值为大数时可读性不强,故建议进行简写,提高数据可读性;
- 大数标准:中英文环境大数标准及简写原则和数据量单位中原则保持一致。
组合单位
- 数据单位为组合单位要求必须展示单位;
- 换算和数据展示规范与其对应的基本单位一致;(注:当数量类单位为组合单位靠近数值的单位时,不可忽略)
参考文档
GB 3100-1993《国际单位制及其应用》