Debounce dashboard refresh dispatches in the webhook function

Open
#172 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

  • #176 by @trask — closed without merging

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
48/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Quiet
Tech stack
github-actions
Domain
ci-cd, cloud, devops

Research direction

Locate the Netlify webhook function, its Netlify Blobs usage, and the existing hourly cron or scheduled function. Trace how accepted events currently dispatch workflows, then compare the implementation with the proposed repository-and-PR debounce state. Done means bursty events produce one trailing dispatch after the quiet period, updates are not dropped during concurrent writes, and the hourly backstop remains effective.

Written by the indexing model from the issue text.

Description

The Netlify webhook dispatches one workflow run per accepted event. Bursty repositories generate far more runs than the dashboard needs, and job-level concurrency then cancels most of them.

Measured on 2026-07-28 against opentelemetry-collector-contrib:

  • GitHub Actions opens a separate check suite per workflow, so one push to a PR produces ~17 check_suite.completed events, hence 17 dispatches.
  • Worst burst observed: 53 dispatches for a single PR in 77 seconds.
  • Across a sample of 1,501 dashboard-eligible events, 82% were check_suite.completed.
  • 81% of completed dashboard runs in the sampled window were cancelled by concurrency.

Every dispatch in a burst produces the same dashboard output, because each run re-reads the full statusCheckRollup. Only the last one carries new information.

Proposal: collapse events per repository + PR number before dispatching.

  • On each accepted webhook, record lastEventAt in a Netlify Blobs entry keyed by ${repository}#${pr_number} instead of dispatching.
  • A scheduled function runs every minute and dispatches once a PR has been quiet for ~45s, then records lastDispatchAt.
  • Flush on lastDispatchAt < lastEventAt rather than a boolean, so a lost update from concurrent writes costs one extra tick instead of a dropped refresh.

Simulated against the real event stream, a 60s trailing debounce on all events removes 66% of dispatches. Leading-edge and check-suite-only variants both scored worse (54% and 52%), so the simplest policy is also the best one.

Trade-off: refresh latency goes from near zero to roughly 45-105 seconds. The hourly cron remains the backstop, and duplicate dispatches stay harmless because the existing concurrency group absorbs them.

Dominant language
JavaScript
Stars
7
Forks
23
Avg merge
15h 46m
Merged PRs (30d)
41

Getting set up

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.

More from open-telemetry/shared-workflows

All issues in open-telemetry/shared-workflows

Similar issues

More JavaScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.