46-EFT.WP.Data.Benchmarks v1.0 | 第10章 运行环境与计量负载

目录 ／ 文档-技术白皮书 ／ 46-EFT.WP.Data.Benchmarks v1.0

第10章 运行环境与计量负载

I. 章节目的与范围

II. 术语与依赖

1. 术语：deps_lock、container@digest、power_meter、P_idle/P_load、QPS、T_inf、ρ、p50/p95/p99、pin_core/numa_aware、throttle/limit、cooldown。
2. 依赖：单位与量纲校核（《Core.Metrology v1.0:check_dim》）；编排/调度/资源（《Pipeline v1.0》第10/12/13章）；评测协议（《ModelCards v1.0》第11章）；指标体系（本卷第6章）。
3. 数学与符号：内联符号用反引号；含除号/积分/复合算符必须加括号；如涉路径量 T_arr，采用
   • T_arr = ( 1 / c_ref ) * ( ∫ n_eff d ell ) 或
   • T_arr = ( ∫ ( n_eff / c_ref ) d ell )，并声明 gamma(ell) 与 d ell；公式/符号/定义禁用中文。

III. 字段与结构（规范性）

env:

hardware:

cpu: "16c@3.0GHz | model-id"

mem_gb: 64

gpu: "0|A100-40GB:x1"

storage: {type:"ssd|nvme|hdd", iops:">=50k", size_gb: 512}

network: {nic_gbps: 10}

power_meter: {make:"yokogawa|on-chip", sample_hz: 1}

os: "ubuntu-22.04"

kernel: "linux-6.8"

containers: ["ghcr.io/eift/runner@sha256:<hex>"]

deps_lock: "env.lock" # 语言/库/驱动精确版本

process:

pin_core: true

numa_aware: true

threads: {workers: 8, threads_per_worker: 2}

limits:

concurrency: 64

rate_limit_qps: 500

memory_gb: 32

caching:

enabled: false

policy: "none|warm|full"

power_policy:

idle_w: null

cap_w: null

IV. 计量负载与功耗口径

• 性能：以 SI 计量报告 QPS(1/s)、latency_ms.{p50,p95,p99}、利用率 ρ；离线与在线窗口一致（1m|5m|15m）。
• 功耗/能耗：采样频率 sample_hz；报告 P_idle/P_load、平均功耗 P_avg(W) 与单位样本能耗 E_per_req(Wh/1k req)；若用板载计量器，应注明校准与误差范围。
• 环境对比：不同硬件/容器/驱动版本产生的差异需以 Δ±CI_95 表示，纳入结果报告。

V. 并发、配额与节流

• 并发/速率：concurrency/rate_limit_qps 必显式；若与评测协议冲突，以协议为准并在环境节复述。
• 配额：内存/显存/存储与网络带宽限制需锁定；触发节流（throttle）与拒绝策略需记录。
• 冷却：压测/扩缩采用 cooldown 防抖；记录进入与退出条件。

VI. 压测与剖析

• 压测：阶梯加压（ramp）输出 QPS–latency 曲线；以 saturation_criteria 判定瓶颈。
• 剖析：使用 perf/py-spy/jfr/flamegraph 归因 CPU/内存/IO/网络；固定采样周期与采样比；导出火焰图与热点清单。
• 复现实验：提供脚本与参数，保证在相同 env.lock 与容器 digest 下结果可重现。

VII. 可复现与敏感度分析

• 锁定：containers@digest、deps_lock、内核与驱动版本；
• 随机性：固定 seed 并记录框架（如 MKL/OMP）线程亲和策略；
• 敏感度：改变单一因素（CPU 型号/功耗上限/缓存策略）测得 Δ，以 CI_95 报告影响并在排行榜注记。

VIII. 计量与单位（SI）

• 强制：metrology:{units:"SI", check_dim:true}；性能/功耗/能耗/体量/网络均用 SI；复合量合成前先做单位归一。
• 路径量：若环境或计量涉及 T_arr，登记 delta_form/path/measure 并按两种等价式通过 check_dim。

IX. 机器可读片段（可直接嵌入）

env:

hardware:

cpu: "AmdEPYC-32c@2.8GHz"

mem_gb: 128

gpu: "A100-40GB:x1"

storage: {type:"nvme", iops:">=200k", size_gb:1000}

network: {nic_gbps: 25}

power_meter: {make:"yokogawa", sample_hz:1}

os: "ubuntu-22.04"

kernel: "linux-6.8"

containers: ["ghcr.io/eift/runner@sha256:abcdef..."]

deps_lock: "env.lock"

process: {pin_core:true, numa_aware:true, threads:{workers:16, threads_per_worker:2}}

limits: {concurrency:128, rate_limit_qps:1000, memory_gb:64}

caching: {enabled:true, policy:"warm"}

power_policy: {idle_w:80, cap_w:300}

reporting:

perf: ["QPS","latency_ms.p99","ρ"]

power: ["P_avg","E_per_req"]

window: "1m"

metrology: {units:"SI", check_dim:true}

X. Lint 规则（节选，规范性）

lint_rules:

- id: ENV.CONTAINER_DIGEST

when: "$.env.containers[*]"

assert: "matches('^.+@sha256:[0-9a-f]{64}$')"

level: error

- id: ENV.DEPS_LOCK_PRESENT

when: "$.env.deps_lock"

assert: "value != null"

level: error

- id: ENV.LIMITS_DEFINED

when: "$.env.limits"

assert: "has_keys(concurrency, rate_limit_qps, memory_gb)"

level: error

- id: POWER.METER_DEFINED

when: "$.env.hardware.power_meter"

assert: "has_keys(make, sample_hz)"

level: error

- id: REPORT.WINDOW_ALLOWED

when: "$.reporting.window"

assert: "value in ['1m','5m','15m']"

level: error

- id: METROLOGY.SI_AND_CHECKDIM

when: "$.metrology"

assert: "units == 'SI' and check_dim == true"

level: error

XI. 交叉引用锚点

• 调度与资源：见《EFT.WP.Data.Pipeline v1.0》第10/13章。
• 在线窗口与监控：见《EFT.WP.Data.Pipeline v1.0》第12章。
• 评测协议：见《EFT.WP.Data.ModelCards v1.0》第11章。
• 指标体系与单位：见本卷第6章；单位与量纲校核：见《EFT.WP.Core.Metrology v1.0:check_dim》。

XII. 本章合规自检

• 环境已锁定：容器 @digest、deps_lock、内核/驱动版本、线程与亲和策略明确。
• 并发/速率/配额一致且与评测协议不冲突；节流与冷却策略记录在案。
• 性能与功耗计量采用 SI，QPS/T_inf/ρ/P_avg/E_per_req 报告完整；单位归一合成通过 check_dim。
• 压测与剖析产物（曲线、火焰图、热点清单）已导出；敏感度分析给出 Δ±CI_95。
• 如涉 T_arr，delta_form/path/measure 已登记并通过校核；
• 导出清单列出环境与计量报告及其 sha256，满足发布与复现门槛。