BlueGit

timfa filemanager

Add debug uptime timer

The debug dashboard now shows a live server uptime timer above scheduled restart details, updated every second while the debug modal is open.\n\nThe debug stats payload now includes process uptime fields so the frontend can render this reliably, and tests/docs are updated accordingly.

timfa Tim Falken · pushed by timfa

Authored 2026-05-28 · 5 months ago

Hash
0ed9d51b3161ba8e67f7fe5e7c7c01ce90d5c355
Parent
ae4faf91
6 files changed +66 −3
.github/technical-reference.md +2 −0
@@ -101,6 +101,7 @@
101 101 - GET /api/admin/debug/stream-stats - Also reports host/process memory ({total, free, used, usedPercent, processRssBytes, processHeapUsedBytes}) so streaming lag can be correlated with RAM pressure.
102 102 - GET /api/admin/debug/stream-stats - Also reports the subtitle debug cache directory metadata so admins can open the local subtitle log folder from the debug dashboard.
103 103 - GET /api/admin/debug/stream-stats - Also reports server maintenance diagnostics: auth/share row counts, auth/share cleanup loop snapshots, and scheduled-restart runtime state.
104 - GET /api/admin/debug/stream-stats - Maintenance diagnostics now include process uptime fields (`uptimeMs`, `startedAt`) so the debug dashboard can show a live uptime timer.
104 105
105 106 ## server/routes/files.js
106 107 - GET /api/files/roots - Returns readable roots with display label (alias when configured), originalName, and path.
@@ -252,6 +253,7 @@
252 253 - onBrowserPopState(event) - When history reaches browse index 0, shows: "Do you want to close the application and return to the previous webpage?" and on Yes runs normal browser back navigation.
253 254 - renderDebugDashboardData(data) - Renders the debug dashboard panels, including the subtitle debug cache folder summary and open-folder action.
254 255 - renderDebugDashboardData(data) - Also renders server-maintenance diagnostics (auth/share row totals, maintenance loop last-run telemetry, scheduled restart status/timing).
256 - renderDebugDashboardData(data) - Server maintenance summary now includes a live "Server uptime" timer row above scheduled restart, updated every second while the debug modal is open.
255 257 - performLogout() - Explicit logout path that revokes server session and clears local session state.
256 258 - initAuth() - Restores prior session when valid and auto-logins without credential prompt.
257 259 - showConfirm(title, message, { html, okLabel, modalClass }) - In-page confirm dialog; returns Promise<boolean>. `html=true` renders message as innerHTML (caller must escape user data), `okLabel` overrides the OK button text, and `modalClass` temporarily widens/restyles the dialog for rich content.
@@ -101,6 +101,7 @@
101- GET /api/admin/debug/stream-stats - Also reports host/process memory ({total, free, used, usedPercent, processRssBytes, processHeapUsedBytes}) so streaming lag can be correlated with RAM pressure.
101- GET /api/admin/debug/stream-stats - Also reports host/process memory ({total, free, used, usedPercent, processRssBytes, processHeapUsedBytes}) so streaming lag can be correlated with RAM pressure.
102- GET /api/admin/debug/stream-stats - Also reports the subtitle debug cache directory metadata so admins can open the local subtitle log folder from the debug dashboard.
102- GET /api/admin/debug/stream-stats - Also reports the subtitle debug cache directory metadata so admins can open the local subtitle log folder from the debug dashboard.
103- GET /api/admin/debug/stream-stats - Also reports server maintenance diagnostics: auth/share row counts, auth/share cleanup loop snapshots, and scheduled-restart runtime state.
103- GET /api/admin/debug/stream-stats - Also reports server maintenance diagnostics: auth/share row counts, auth/share cleanup loop snapshots, and scheduled-restart runtime state.
104- GET /api/admin/debug/stream-stats - Maintenance diagnostics now include process uptime fields (`uptimeMs`, `startedAt`) so the debug dashboard can show a live uptime timer.
104
105
105## server/routes/files.js
106## server/routes/files.js
106- GET /api/files/roots - Returns readable roots with display label (alias when configured), originalName, and path.
107- GET /api/files/roots - Returns readable roots with display label (alias when configured), originalName, and path.
@@ -252,6 +253,7 @@
252- onBrowserPopState(event) - When history reaches browse index 0, shows: "Do you want to close the application and return to the previous webpage?" and on Yes runs normal browser back navigation.
253- onBrowserPopState(event) - When history reaches browse index 0, shows: "Do you want to close the application and return to the previous webpage?" and on Yes runs normal browser back navigation.
253- renderDebugDashboardData(data) - Renders the debug dashboard panels, including the subtitle debug cache folder summary and open-folder action.
254- renderDebugDashboardData(data) - Renders the debug dashboard panels, including the subtitle debug cache folder summary and open-folder action.
254- renderDebugDashboardData(data) - Also renders server-maintenance diagnostics (auth/share row totals, maintenance loop last-run telemetry, scheduled restart status/timing).
255- renderDebugDashboardData(data) - Also renders server-maintenance diagnostics (auth/share row totals, maintenance loop last-run telemetry, scheduled restart status/timing).
256- renderDebugDashboardData(data) - Server maintenance summary now includes a live "Server uptime" timer row above scheduled restart, updated every second while the debug modal is open.
255- performLogout() - Explicit logout path that revokes server session and clears local session state.
257- performLogout() - Explicit logout path that revokes server session and clears local session state.
256- initAuth() - Restores prior session when valid and auto-logins without credential prompt.
258- initAuth() - Restores prior session when valid and auto-logins without credential prompt.
257- showConfirm(title, message, { html, okLabel, modalClass }) - In-page confirm dialog; returns Promise<boolean>. `html=true` renders message as innerHTML (caller must escape user data), `okLabel` overrides the OK button text, and `modalClass` temporarily widens/restyles the dialog for rich content.
259- showConfirm(title, message, { html, okLabel, modalClass }) - In-page confirm dialog; returns Promise<boolean>. `html=true` renders message as innerHTML (caller must escape user data), `okLabel` overrides the OK button text, and `modalClass` temporarily widens/restyles the dialog for rich content.
public/app.js +55 −1
@@ -5442,6 +5442,7 @@ async function deleteItem (item)
5442 5442
5443 5443 let _adminUpdateStatus = null;
5444 5444 let _debugRefreshTimer = null;
5445 let _debugUptimeTimer = null;
5445 5446 let _debugLatestData = null;
5446 5447 let _adminConfigCache = null;
5447 5448
@@ -5496,6 +5497,45 @@ function formatTimestamp (ms)
5496 5497 }
5497 5498 }
5498 5499
5500 function formatElapsedDuration (ms)
5501 {
5502 const totalMs = Number(ms || 0);
5503 if (!Number.isFinite(totalMs) || totalMs < 0) return '—';
5504
5505 const totalSeconds = Math.floor(totalMs / 1000);
5506 const days = Math.floor(totalSeconds / 86400);
5507 const hours = Math.floor((totalSeconds % 86400) / 3600);
5508 const minutes = Math.floor((totalSeconds % 3600) / 60);
5509 const seconds = totalSeconds % 60;
5510
5511 const hms = `${String(hours).padStart(2, '0')}:${String(minutes).padStart(2, '0')}:${String(seconds).padStart(2, '0')}`;
5512 if (days <= 0) return hms;
5513 return `${days}d ${hms}`;
5514 }
5515
5516 function getDebugUptimeMsNow ()
5517 {
5518 const data = _debugLatestData || {};
5519 const maintenance = data.maintenance || {};
5520 const baseUptimeMs = Number(maintenance.uptimeMs || 0);
5521 if (!Number.isFinite(baseUptimeMs) || baseUptimeMs < 0) return null;
5522
5523 const generatedAt = Number(data.generatedAt || 0);
5524 const elapsedSinceSnapshotMs = Number.isFinite(generatedAt) && generatedAt > 0
5525 ? Math.max(0, Date.now() - generatedAt)
5526 : 0;
5527 return baseUptimeMs + elapsedSinceSnapshotMs;
5528 }
5529
5530 function renderDebugUptimeTimer ()
5531 {
5532 const valueEl = document.getElementById('debug-maintenance-uptime-value');
5533 if (!valueEl) return;
5534
5535 const uptimeMs = getDebugUptimeMsNow();
5536 valueEl.textContent = uptimeMs === null ? '—' : formatElapsedDuration(uptimeMs);
5537 }
5538
5499 5539 function renderDebugTable (containerId, columns, rows)
5500 5540 {
5501 5541 const container = document.getElementById(containerId);
@@ -5574,10 +5614,13 @@ function renderDebugDashboardData (data)
5574 5614 ['Share tokens (expired)', String(rows.shareTokensExpired || 0)],
5575 5615 ['Auth cleanup last run', formatTimestamp(authCleanup.lastRunAt)],
5576 5616 ['Share cleanup last run', formatTimestamp(shareMaintenance.lastRunAt)],
5617 ['Server uptime', `<span id="debug-maintenance-uptime-value">${escapeHtml(formatElapsedDuration(getDebugUptimeMsNow()))}</span>`],
5577 5618 ['Scheduled restart', scheduledLine],
5578 5619 ['Next scheduled restart', formatTimestamp(scheduledRestart.nextDueAt)],
5579 5620 ['Pending since', formatTimestamp(scheduledRestart.pendingSinceAt)],
5580 ].map(([k, v]) => `<div class="debug-summary-item"><span class="k">${escapeHtml(k)}</span><span class="v">${escapeHtml(v)}</span></div>`).join('');
5621 ].map(([k, v]) => `<div class="debug-summary-item"><span class="k">${escapeHtml(k)}</span><span class="v">${k === 'Server uptime' ? v : escapeHtml(v)}</span></div>`).join('');
5622
5623 renderDebugUptimeTimer();
5581 5624 }
5582 5625
5583 5626 renderDebugTable(
@@ -5806,6 +5849,12 @@ async function openDebugModal ()
5806 5849 {
5807 5850 void refreshDebugDashboard();
5808 5851 }, 5000);
5852
5853 if (_debugUptimeTimer) clearInterval(_debugUptimeTimer);
5854 _debugUptimeTimer = setInterval(() =>
5855 {
5856 renderDebugUptimeTimer();
5857 }, 1000);
5809 5858 }
5810 5859
5811 5860 function closeDebugModal ()
@@ -5817,6 +5866,11 @@ function closeDebugModal ()
5817 5866 clearInterval(_debugRefreshTimer);
5818 5867 _debugRefreshTimer = null;
5819 5868 }
5869 if (_debugUptimeTimer)
5870 {
5871 clearInterval(_debugUptimeTimer);
5872 _debugUptimeTimer = null;
5873 }
5820 5874 }
5821 5875
5822 5876 function animateBadgeToTarget (targetEl)
@@ -5442,6 +5442,7 @@ async function deleteItem (item)
5442
5442
5443let _adminUpdateStatus = null;
5443let _adminUpdateStatus = null;
5444let _debugRefreshTimer = null;
5444let _debugRefreshTimer = null;
5445let _debugUptimeTimer = null;
5445let _debugLatestData = null;
5446let _debugLatestData = null;
5446let _adminConfigCache = null;
5447let _adminConfigCache = null;
5447
5448
@@ -5496,6 +5497,45 @@ function formatTimestamp (ms)
5496 }
5497 }
5497}
5498}
5498
5499
5500function formatElapsedDuration (ms)
5501{
5502 const totalMs = Number(ms || 0);
5503 if (!Number.isFinite(totalMs) || totalMs < 0) return '—';
5504
5505 const totalSeconds = Math.floor(totalMs / 1000);
5506 const days = Math.floor(totalSeconds / 86400);
5507 const hours = Math.floor((totalSeconds % 86400) / 3600);
5508 const minutes = Math.floor((totalSeconds % 3600) / 60);
5509 const seconds = totalSeconds % 60;
5510
5511 const hms = `${String(hours).padStart(2, '0')}:${String(minutes).padStart(2, '0')}:${String(seconds).padStart(2, '0')}`;
5512 if (days <= 0) return hms;
5513 return `${days}d ${hms}`;
5514}
5515
5516function getDebugUptimeMsNow ()
5517{
5518 const data = _debugLatestData || {};
5519 const maintenance = data.maintenance || {};
5520 const baseUptimeMs = Number(maintenance.uptimeMs || 0);
5521 if (!Number.isFinite(baseUptimeMs) || baseUptimeMs < 0) return null;
5522
5523 const generatedAt = Number(data.generatedAt || 0);
5524 const elapsedSinceSnapshotMs = Number.isFinite(generatedAt) && generatedAt > 0
5525 ? Math.max(0, Date.now() - generatedAt)
5526 : 0;
5527 return baseUptimeMs + elapsedSinceSnapshotMs;
5528}
5529
5530function renderDebugUptimeTimer ()
5531{
5532 const valueEl = document.getElementById('debug-maintenance-uptime-value');
5533 if (!valueEl) return;
5534
5535 const uptimeMs = getDebugUptimeMsNow();
5536 valueEl.textContent = uptimeMs === null ? '—' : formatElapsedDuration(uptimeMs);
5537}
5538
5499function renderDebugTable (containerId, columns, rows)
5539function renderDebugTable (containerId, columns, rows)
5500{
5540{
5501 const container = document.getElementById(containerId);
5541 const container = document.getElementById(containerId);
@@ -5574,10 +5614,13 @@ function renderDebugDashboardData (data)
5574 ['Share tokens (expired)', String(rows.shareTokensExpired || 0)],
5614 ['Share tokens (expired)', String(rows.shareTokensExpired || 0)],
5575 ['Auth cleanup last run', formatTimestamp(authCleanup.lastRunAt)],
5615 ['Auth cleanup last run', formatTimestamp(authCleanup.lastRunAt)],
5576 ['Share cleanup last run', formatTimestamp(shareMaintenance.lastRunAt)],
5616 ['Share cleanup last run', formatTimestamp(shareMaintenance.lastRunAt)],
5617 ['Server uptime', `<span id="debug-maintenance-uptime-value">${escapeHtml(formatElapsedDuration(getDebugUptimeMsNow()))}</span>`],
5577 ['Scheduled restart', scheduledLine],
5618 ['Scheduled restart', scheduledLine],
5578 ['Next scheduled restart', formatTimestamp(scheduledRestart.nextDueAt)],
5619 ['Next scheduled restart', formatTimestamp(scheduledRestart.nextDueAt)],
5579 ['Pending since', formatTimestamp(scheduledRestart.pendingSinceAt)],
5620 ['Pending since', formatTimestamp(scheduledRestart.pendingSinceAt)],
5580 ].map(([k, v]) => `<div class="debug-summary-item"><span class="k">${escapeHtml(k)}</span><span class="v">${escapeHtml(v)}</span></div>`).join('');
5621 ].map(([k, v]) => `<div class="debug-summary-item"><span class="k">${escapeHtml(k)}</span><span class="v">${k === 'Server uptime' ? v : escapeHtml(v)}</span></div>`).join('');
5622
5623 renderDebugUptimeTimer();
5581 }
5624 }
5582
5625
5583 renderDebugTable(
5626 renderDebugTable(
@@ -5806,6 +5849,12 @@ async function openDebugModal ()
5806 {
5849 {
5807 void refreshDebugDashboard();
5850 void refreshDebugDashboard();
5808 }, 5000);
5851 }, 5000);
5852
5853 if (_debugUptimeTimer) clearInterval(_debugUptimeTimer);
5854 _debugUptimeTimer = setInterval(() =>
5855 {
5856 renderDebugUptimeTimer();
5857 }, 1000);
5809}
5858}
5810
5859
5811function closeDebugModal ()
5860function closeDebugModal ()
@@ -5817,6 +5866,11 @@ function closeDebugModal ()
5817 clearInterval(_debugRefreshTimer);
5866 clearInterval(_debugRefreshTimer);
5818 _debugRefreshTimer = null;
5867 _debugRefreshTimer = null;
5819 }
5868 }
5869 if (_debugUptimeTimer)
5870 {
5871 clearInterval(_debugUptimeTimer);
5872 _debugUptimeTimer = null;
5873 }
5820}
5874}
5821
5875
5822function animateBadgeToTarget (targetEl)
5876function animateBadgeToTarget (targetEl)
public/index.html +2 −1
@@ -244,7 +244,8 @@
244 244 <input id="admin-scheduled-restart-time" type="time" step="60" />
245 245 </label>
246 246 </div>
247 <p id="admin-scheduled-restart-help" class="muted">When the scheduled time is reached, restart waits until there have been no logged-in clients for at least one hour.</p>
247 <p id="admin-scheduled-restart-help" class="muted">When the scheduled time is reached, restart waits until
248 there have been no logged-in clients for at least one hour.</p>
248 249 <button id="admin-save-scheduled-restart" class="primary">Save scheduled restart</button>
249 250 </div>
250 251 <button id="admin-shutdown-btn" class="danger">Shut down server</button>
@@ -244,7 +244,8 @@
244 <input id="admin-scheduled-restart-time" type="time" step="60" />
244 <input id="admin-scheduled-restart-time" type="time" step="60" />
245 </label>
245 </label>
246 </div>
246 </div>
247 <p id="admin-scheduled-restart-help" class="muted">When the scheduled time is reached, restart waits until there have been no logged-in clients for at least one hour.</p>
247 <p id="admin-scheduled-restart-help" class="muted">When the scheduled time is reached, restart waits until
248 there have been no logged-in clients for at least one hour.</p>
248 <button id="admin-save-scheduled-restart" class="primary">Save scheduled restart</button>
249 <button id="admin-save-scheduled-restart" class="primary">Save scheduled restart</button>
249 </div>
250 </div>
250 <button id="admin-shutdown-btn" class="danger">Shut down server</button>
251 <button id="admin-shutdown-btn" class="danger">Shut down server</button>
server/routes/debug.js +4 −0
@@ -239,8 +239,12 @@ function getMaintenanceSnapshot ()
239 239 const scheduledRestart = typeof restartScheduler.getRestartSchedulerSnapshot === 'function'
240 240 ? restartScheduler.getRestartSchedulerSnapshot()
241 241 : null;
242 const uptimeMs = Math.max(0, Math.floor(Number(process.uptime()) * 1000));
243 const startedAt = Date.now() - uptimeMs;
242 244
243 245 return {
246 uptimeMs,
247 startedAt,
244 248 rows: {
245 249 authSessionsTotal: Number(authRows.total || 0),
246 250 authSessionsActive: Number(authRows.active || 0),
@@ -239,8 +239,12 @@ function getMaintenanceSnapshot ()
239 const scheduledRestart = typeof restartScheduler.getRestartSchedulerSnapshot === 'function'
239 const scheduledRestart = typeof restartScheduler.getRestartSchedulerSnapshot === 'function'
240 ? restartScheduler.getRestartSchedulerSnapshot()
240 ? restartScheduler.getRestartSchedulerSnapshot()
241 : null;
241 : null;
242 const uptimeMs = Math.max(0, Math.floor(Number(process.uptime()) * 1000));
243 const startedAt = Date.now() - uptimeMs;
242
244
243 return {
245 return {
246 uptimeMs,
247 startedAt,
244 rows: {
248 rows: {
245 authSessionsTotal: Number(authRows.total || 0),
249 authSessionsTotal: Number(authRows.total || 0),
246 authSessionsActive: Number(authRows.active || 0),
250 authSessionsActive: Number(authRows.active || 0),
tests/admin.routes.test.js +2 −0
@@ -538,6 +538,8 @@ describe('GET /api/admin/debug/stream-stats', () =>
538 538 expect(status).toBe(200);
539 539 expect(Array.isArray(body.videoFiles)).toBe(true);
540 540 expect(body.maintenance).toEqual(expect.objectContaining({
541 uptimeMs: expect.any(Number),
542 startedAt: expect.any(Number),
541 543 rows: expect.objectContaining({
542 544 authSessionsTotal: expect.any(Number),
543 545 shareTokensTotal: expect.any(Number),
@@ -538,6 +538,8 @@ describe('GET /api/admin/debug/stream-stats', () =>
538 expect(status).toBe(200);
538 expect(status).toBe(200);
539 expect(Array.isArray(body.videoFiles)).toBe(true);
539 expect(Array.isArray(body.videoFiles)).toBe(true);
540 expect(body.maintenance).toEqual(expect.objectContaining({
540 expect(body.maintenance).toEqual(expect.objectContaining({
541 uptimeMs: expect.any(Number),
542 startedAt: expect.any(Number),
541 rows: expect.objectContaining({
543 rows: expect.objectContaining({
542 authSessionsTotal: expect.any(Number),
544 authSessionsTotal: expect.any(Number),
543 shareTokensTotal: expect.any(Number),
545 shareTokensTotal: expect.any(Number),
tests/share.page.load.test.js +1 −1
@@ -201,7 +201,7 @@ describe('share page video preview', () =>
201 201
202 202 class MockButton
203 203 {
204 constructor (player)
204 constructor(player)
205 205 {
206 206 this._player = player;
207 207 this._el = null;
@@ -201,7 +201,7 @@ describe('share page video preview', () =>
201
201
202 class MockButton
202 class MockButton
203 {
203 {
204 constructor (player)
204 constructor(player)
205 {
205 {
206 this._player = player;
206 this._player = player;
207 this._el = null;
207 this._el = null;