perf: record stage timing distributions and expand capture metadata #1097

Merged
SakulFlee merged 3 commits from sakulflee/perf-stage-distributions into main 2026-11-10 23:17:25 +00:00 AGit
Owner

Adds per-stage min/max/p95 distributions, timing-window sample counts and wall-clock deltas, stale GPU-timestamp markers, git revision and Android performance state in the metadata sidecar, and notebook visualisations for issue #1078.

Adds per-stage min/max/p95 distributions, timing-window sample counts and wall-clock deltas, stale GPU-timestamp markers, git revision and Android performance state in the metadata sidecar, and notebook visualisations for issue #1078.
The one-second CSV window now keeps per-stage min, max and p95 values alongside the existing means, plus frame count, wall-clock delta mean/min/max/p95, and a stale GPU-timestamp marker. TimingWindow is computed from a per-window sample buffer so CSV capture does not depend on debug-graph history.
Capture metadata now includes the git revision from a small build script and, on Android, the active refresh rate, ADPF target duration, sustained-performance state, power-save state, and game mode.
docs(perf): document and visualise timing distributions
All checks were successful
Lint / lint (pull_request) Successful in 1m24s
PR / test (pull_request) Successful in 13m21s
364a625052
Document the distribution columns, timing-window fields, stale GPU-timestamp marker, git revision, and Android metadata. The notebook now excludes the new columns from stage means and adds a p95/max ranking plus per-stage distribution plots.

Smart test results

Result: PASS

Scope: full workspace

Reason: unmapped change: Tools/performance/performance_report.ipynb

Elapsed: 13m 2s

Workflow run

Overall: 527 tests, 517 passed, 0 failed, 10 skipped

Nextest: 516 tests, 516 passed, 0 failed, 0 skipped
Doctests: 11 tests, 1 passed, 0 failed, 10 skipped

Outcome charts are split between nextest and doctests. The timing chart covers nextest only.

Crate Nextest Passed Failed Skipped Doctests Time
orbital 1 1 0 0 - 0.65s
orbital-cli 3 3 0 0 - 0.04s
orbital_2d 29 29 0 0 0/1 0.18s
orbital_app 25 25 0 0 0/1 0.15s
orbital_billboard 9 9 0 0 - 0.24s
orbital_camera 8 8 0 0 - 0.05s
orbital_core 2 2 0 0 - 0.01s
orbital_debug_render 2 2 0 0 0/1 0.01s
orbital_debug_ui 51 51 0 0 0/1 0.33s
orbital_ecs 114 114 0 0 0/2 0.69s
orbital_ecs_bridge 46 46 0 0 - 0.29s
orbital_file_manager 5 5 0 0 - 0.03s
orbital_iced 26 26 0 0 - 0.14s
orbital_importer_gltf 16 16 0 0 - 0.15s
orbital_input 11 11 0 0 - 0.06s
orbital_light 8 8 0 0 - 0.04s
orbital_macros 0 0 0 0 0/1 0.00s
orbital_material_shader 2 2 0 0 - 0.01s
orbital_math 4 4 0 0 - 0.02s
orbital_mesh 2 2 0 0 - 0.01s
orbital_procgeo 3 3 0 0 - 0.02s
orbital_render_graph 6 6 0 0 - 0.03s
orbital_renderer 22 22 0 0 - 0.25s
orbital_resources 29 29 0 0 - 0.19s
orbital_shader_core 0 0 0 0 1/1 0.00s
orbital_shader_pbr 4 4 0 0 - 0.02s
orbital_shader_preprocessor 12 12 0 0 - 0.06s
orbital_shadow 3 3 0 0 - 0.01s
orbital_text 14 14 0 0 0/1 0.30s
orbital_texture 11 11 0 0 - 0.05s
orbital_touch_ui 1 1 0 0 0/1 0.01s
orbital_ui 32 32 0 0 0/1 0.16s
orbital_world_environment 13 13 0 0 - 0.07s
template_all_in_one 2 2 0 0 - 0.01s
pie showData
    title Nextest outcomes
    "Passed" : 516
pie showData
    title Doctest outcomes
    "Passed" : 1
    "Skipped" : 10
xychart-beta
    title "Slowest crates (nextest seconds)"
    x-axis ["orbital_ecs", "orbital", "orbital_debug_ui", "orbital_text", "orbital_ecs_bridge", "orbital_renderer", "orbital_billboard", "orbital_resources"]
    y-axis "Seconds" 0 --> 1
    bar [0.69, 0.65, 0.33, 0.30, 0.29, 0.25, 0.24, 0.19]
<!-- orbital-ci-test-results --> ## Smart test results **Result:** PASS **Scope:** full workspace **Reason:** unmapped change: Tools/performance/performance_report.ipynb **Elapsed:** 13m 2s [Workflow run](https://forgejo.sakul-flee.de/SakulFlee/Orbital/actions/runs/1217) **Overall:** 527 tests, 517 passed, 0 failed, 10 skipped **Nextest:** 516 tests, 516 passed, 0 failed, 0 skipped **Doctests:** 11 tests, 1 passed, 0 failed, 10 skipped _Outcome charts are split between nextest and doctests. The timing chart covers nextest only._ | Crate | Nextest | Passed | Failed | Skipped | Doctests | Time | | --- | ---: | ---: | ---: | ---: | ---: | ---: | | orbital | 1 | 1 | 0 | 0 | - | 0.65s | | orbital-cli | 3 | 3 | 0 | 0 | - | 0.04s | | orbital_2d | 29 | 29 | 0 | 0 | 0/1 | 0.18s | | orbital_app | 25 | 25 | 0 | 0 | 0/1 | 0.15s | | orbital_billboard | 9 | 9 | 0 | 0 | - | 0.24s | | orbital_camera | 8 | 8 | 0 | 0 | - | 0.05s | | orbital_core | 2 | 2 | 0 | 0 | - | 0.01s | | orbital_debug_render | 2 | 2 | 0 | 0 | 0/1 | 0.01s | | orbital_debug_ui | 51 | 51 | 0 | 0 | 0/1 | 0.33s | | orbital_ecs | 114 | 114 | 0 | 0 | 0/2 | 0.69s | | orbital_ecs_bridge | 46 | 46 | 0 | 0 | - | 0.29s | | orbital_file_manager | 5 | 5 | 0 | 0 | - | 0.03s | | orbital_iced | 26 | 26 | 0 | 0 | - | 0.14s | | orbital_importer_gltf | 16 | 16 | 0 | 0 | - | 0.15s | | orbital_input | 11 | 11 | 0 | 0 | - | 0.06s | | orbital_light | 8 | 8 | 0 | 0 | - | 0.04s | | orbital_macros | 0 | 0 | 0 | 0 | 0/1 | 0.00s | | orbital_material_shader | 2 | 2 | 0 | 0 | - | 0.01s | | orbital_math | 4 | 4 | 0 | 0 | - | 0.02s | | orbital_mesh | 2 | 2 | 0 | 0 | - | 0.01s | | orbital_procgeo | 3 | 3 | 0 | 0 | - | 0.02s | | orbital_render_graph | 6 | 6 | 0 | 0 | - | 0.03s | | orbital_renderer | 22 | 22 | 0 | 0 | - | 0.25s | | orbital_resources | 29 | 29 | 0 | 0 | - | 0.19s | | orbital_shader_core | 0 | 0 | 0 | 0 | 1/1 | 0.00s | | orbital_shader_pbr | 4 | 4 | 0 | 0 | - | 0.02s | | orbital_shader_preprocessor | 12 | 12 | 0 | 0 | - | 0.06s | | orbital_shadow | 3 | 3 | 0 | 0 | - | 0.01s | | orbital_text | 14 | 14 | 0 | 0 | 0/1 | 0.30s | | orbital_texture | 11 | 11 | 0 | 0 | - | 0.05s | | orbital_touch_ui | 1 | 1 | 0 | 0 | 0/1 | 0.01s | | orbital_ui | 32 | 32 | 0 | 0 | 0/1 | 0.16s | | orbital_world_environment | 13 | 13 | 0 | 0 | - | 0.07s | | template_all_in_one | 2 | 2 | 0 | 0 | - | 0.01s | ```mermaid pie showData title Nextest outcomes "Passed" : 516 ``` ```mermaid pie showData title Doctest outcomes "Passed" : 1 "Skipped" : 10 ``` ```mermaid xychart-beta title "Slowest crates (nextest seconds)" x-axis ["orbital_ecs", "orbital", "orbital_debug_ui", "orbital_text", "orbital_ecs_bridge", "orbital_renderer", "orbital_billboard", "orbital_resources"] y-axis "Seconds" 0 --> 1 bar [0.69, 0.65, 0.33, 0.30, 0.29, 0.25, 0.24, 0.19] ```
Author
Owner

Closes #1078

Closes #1078
Sign in to join this conversation.
No description provided.