Files
browser/openspec/changes/report-run-server-metrics/proposal.md
T

26 lines
1.2 KiB
Markdown

## Why
Generated Run packages register and supervise their server process, but never submit a metric sample. The platform consequently has no observed metrics and correctly renders every such server as waiting for Run reporting.
## What Changes
- Add Run-side periodic metric reporting for its bound server instance after registration.
- Derive online state only from Run's generic supervised-process records; report no game-specific player, TPS, or latency values.
- Include bounded host CPU, memory, and workspace-volume usage when the operating system collector can observe them, without exposing paths or credentials.
- Keep metric delivery on an independent, bounded reporting path so failed metric uploads do not block control, lifecycle jobs, logs, or artifacts.
## Capabilities
### New Capabilities
- `run-server-metrics`: Generic server-process and host-resource metric collection and Run-to-platform reporting.
### Modified Capabilities
- None.
## Impact
- Affects the independent `run/` runtime worker, its platform client contract implementation, and Run tests.
- Uses the existing signed `POST /api/v1/run/metrics/batches` platform route; no browser or game-plugin contract changes are required.