summaryrefslogtreecommitdiff
path: root/internal/flamegraph
diff options
context:
space:
mode:
authorPaul Buetow <paul@buetow.org>2026-03-03 13:10:18 +0200
committerPaul Buetow <paul@buetow.org>2026-03-03 13:10:18 +0200
commit6907c5db1125cc385694f1c4283144f7d03b020e (patch)
tree304347f8eac5adad6c1ad76ade503fe37113d774 /internal/flamegraph
parentd80acf0c92ad4b436c23ac881ec24485297a80d8 (diff)
Add watch mode for dynamic flamegraph updates
Diffstat (limited to 'internal/flamegraph')
-rw-r--r--internal/flamegraph/webserver.go64
-rw-r--r--internal/flamegraph/webserver_autoreload_test.go37
2 files changed, 101 insertions, 0 deletions
diff --git a/internal/flamegraph/webserver.go b/internal/flamegraph/webserver.go
index 2bf6286..c472dfb 100644
--- a/internal/flamegraph/webserver.go
+++ b/internal/flamegraph/webserver.go
@@ -43,6 +43,30 @@ func ServeSVG(svgFile string) error {
})
}
+// ServeSVGAutoReload serves an SVG viewer page that periodically reloads the SVG.
+//
+// The SVG file itself is still served directly at its absolute URL path, while "/"
+// serves a small HTML wrapper that appends a cache-busting query parameter on each
+// refresh interval to pick up newly written SVG content.
+func ServeSVGAutoReload(svgFile string, refreshInterval time.Duration) error {
+ if refreshInterval <= 0 {
+ return fmt.Errorf("refresh interval must be > 0")
+ }
+
+ absPath, err := filepath.Abs(svgFile)
+ if err != nil {
+ return fmt.Errorf("resolve svg path: %w", err)
+ }
+ urlPath := buildURLPath(absPath)
+ ctx, stop := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM)
+ defer stop()
+
+ mux := buildSVGAutoReloadHandler(absPath, urlPath, refreshInterval)
+ return runServer(ctx, mux, defaultServerTimeouts, func(hostname string, port int) {
+ printServerURL(hostname, port, "/")
+ })
+}
+
func buildURLPath(absPath string) string {
urlPath := filepath.ToSlash(absPath)
if !strings.HasPrefix(urlPath, "/") {
@@ -62,6 +86,46 @@ func buildSVGHandler(absPath, urlPath string) *http.ServeMux {
return mux
}
+func buildSVGAutoReloadHandler(absPath, urlPath string, refreshInterval time.Duration) *http.ServeMux {
+ intervalMs := refreshInterval.Milliseconds()
+ mux := http.NewServeMux()
+ mux.HandleFunc("/", func(w http.ResponseWriter, _ *http.Request) {
+ w.Header().Set("Content-Type", "text/html; charset=utf-8")
+ _, _ = fmt.Fprintf(w, `<!doctype html>
+<html>
+<head>
+ <meta charset="utf-8"/>
+ <meta name="viewport" content="width=device-width, initial-scale=1"/>
+ <title>I/O Flamegraph (Auto-Reload)</title>
+ <style>
+ body { margin: 0; font-family: monospace; }
+ .bar { padding: 8px 12px; border-bottom: 1px solid #ddd; }
+ .viewer { width: 100%%; height: calc(100vh - 42px); border: 0; display: block; }
+ </style>
+</head>
+<body>
+ <div class="bar">
+ Auto-refresh every %d ms.
+ <button type="button" onclick="refreshNow()">Refresh now</button>
+ </div>
+ <iframe id="fg" class="viewer" src="%s"></iframe>
+ <script>
+ const base = %q;
+ function refreshNow() {
+ document.getElementById("fg").src = base + "?t=" + Date.now();
+ }
+ setInterval(refreshNow, %d);
+ </script>
+</body>
+</html>
+`, intervalMs, urlPath, urlPath, intervalMs)
+ })
+ mux.HandleFunc(urlPath, func(w http.ResponseWriter, r *http.Request) {
+ http.ServeFile(w, r, absPath)
+ })
+ return mux
+}
+
func listenRandomPort() (net.Listener, error) {
listener, err := net.Listen("tcp", ":0")
if err != nil {
diff --git a/internal/flamegraph/webserver_autoreload_test.go b/internal/flamegraph/webserver_autoreload_test.go
new file mode 100644
index 0000000..ed4c907
--- /dev/null
+++ b/internal/flamegraph/webserver_autoreload_test.go
@@ -0,0 +1,37 @@
+package flamegraph
+
+import (
+ "net/http/httptest"
+ "strings"
+ "testing"
+ "time"
+)
+
+func TestBuildSVGAutoReloadHandlerServesViewerPage(t *testing.T) {
+ mux := buildSVGAutoReloadHandler("/tmp/fake.svg", "/tmp/fake.svg", 2*time.Second)
+
+ rec := httptest.NewRecorder()
+ req := httptest.NewRequest("GET", "http://localhost/", nil)
+ mux.ServeHTTP(rec, req)
+
+ if rec.Code != 200 {
+ t.Fatalf("status code = %d, want 200", rec.Code)
+ }
+ if got := rec.Header().Get("Content-Type"); !strings.HasPrefix(got, "text/html") {
+ t.Fatalf("content type = %q, want text/html", got)
+ }
+ body := rec.Body.String()
+ if !strings.Contains(body, "Auto-refresh every 2000 ms.") {
+ t.Fatalf("viewer page missing refresh interval, body=%q", body)
+ }
+ if !strings.Contains(body, `id="fg"`) {
+ t.Fatalf("viewer page missing iframe, body=%q", body)
+ }
+}
+
+func TestServeSVGAutoReloadRejectsNonPositiveInterval(t *testing.T) {
+ err := ServeSVGAutoReload("ignored.svg", 0)
+ if err == nil {
+ t.Fatal("expected error for non-positive interval")
+ }
+}