clockworklabs / clockworklabs/SpacetimeDB

maincloud metrics

Open
#5,270 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

feature-request
Dominant language
Rust
Stars
25.2k
Forks
1.1k
Avg merge
2d 7h
Merged PRs (30d)
46

Description

the metrics pages are nice and useful but it isn't clear what the graphs are actually showing. some of them are showing the accumulated values per minute, some per 30 or 15 seconds and some have their time scale all over the place depending how the graph loaded.
for some i don't even know what to do with the value like the table storage being in mb but being calculated as GB-seconds in the energy usage.
i have one reducer that runs every 2 seconds and the graph shows it as 1.6 to 2 TPS with a time scale step of 30 seconds. is that an accumulated value too? how does it get to 2TPS? at best this is VERY misleading.

besides that, why aren't the metrics stored in a st_metrics (event) table that the dashboard can just load from the clog or at least get as subcription. this also would allow the standalone version to have metrics too.

Requested by @xDovos via the SpacetimeDB site.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start at the maincloud metrics pages and trace how graph values, time-scale steps, reducer rates, table storage, and energy usage are calculated and displayed. Compare the behavior across the mentioned intervals and investigate the proposed st_metrics event-table path for dashboard and standalone metrics. Done means the metric units and aggregation windows are consistent and clearly defined, with the storage approach scoped.

Written by the indexing model from the issue text.

Assessment

Tech stack
rust
Domain
databases, observability
Issue type
Bug
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.