getsentry / getsentry/sentry

Metric charts: annotate the timeline when a metric's equation/definition changes

Open
#118,214 3 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

3. Medium Feature Product Area: Alerts Waiting for: Product Owner
Dominant language
Python
Stars
44.8k
Forks
4.9k
Avg merge
21h 23m
Merged PRs (30d)
607

Description

Problem Statement

When a metric (or metric alert) is defined with an equation, its historical chart reflects whatever the equation was at each point in time. There is currently no visual indicator on the chart marking when the equation or definition was edited. Any user who iterates on a metric definition is left unable to tell whether a shift in the chart is a real change in the underlying signal or simply the result of the equation being changed.

Why the current behavior is insufficient
Historical variation that comes from an equation edit is visually indistinguishable from real movement in the data. This makes the history hard to interpret and erodes trust in the displayed values, especially for teams standing up new metrics and tuning them over several iterations.

Solution Brainstorm

Render a vertical annotation/marker on the time-series chart at each timestamp where the metric's equation or definition changed (label e.g. "Equation updated"). On hover, show the previous vs. new equation. Optionally expose a small version history/changelog of equation definitions for the metric.

Product Area

Alerts

Contributor guide

Open the contributing guide

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

No files, tests, or entry points are named. Start by locating the metric and metric-alert time-series chart and the history of equation or definition edits; done means the chart marks each change and exposes the previous and new equations on hover, with any version-history scope decided.

Written by the indexing model from the issue text.

Assessment

Domain
observability
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.