'use strict'; /* global deviceUrl, FACEPLATES, renderFaceplate, faceplateScrollLeft */ /* exported renderPortInspector, fmtRate, fmtErrors */ // Port inspector for a switch or router's device page: front-panel diagram, // port detail panel, switch/server path check, and link diagnostics. const escHtml = s => lt.escHtml(s); // ── Formatting helpers ─────────────────────────────────────────────────── function fmtShortSpeed(mbps) { if (!mbps) return '-'; if (mbps >= 1000) return (mbps / 1000).toFixed(0) + 'G'; return mbps + 'M'; } function fmtRate(bytesPerSec) { if (bytesPerSec === null || bytesPerSec === undefined) return '-'; const bps = bytesPerSec * 8; if (bps < 1e3) return bps.toFixed(0) + ' bps'; if (bps < 1e6) return (bps / 1e3).toFixed(1) + ' Kbps'; if (bps < 1e9) return (bps / 1e6).toFixed(2) + ' Mbps'; return (bps / 1e9).toFixed(3) + ' Gbps'; } function fmtErrors(rate) { if (rate === null || rate === undefined) return '-'; if (rate < 0.001) return '0 /s'; return `${rate.toFixed(3)} /s`; } // ── Build port_idx → port data map ────────────────────────────────────── function buildPortIdxMap(ports) { const map = {}; for (const [pname, d] of Object.entries(ports)) { if (d.port_idx != null) { map[d.port_idx] = Object.assign({ name: pname }, d); } } return map; } // ── Determine port block CSS state class ──────────────────────────────── function portBlockState(d) { if (!d || !d.up) return 'down'; if (d.is_uplink) return 'uplink'; if (d.poe_power != null && d.poe_power > 0) return 'poe-active'; return 'up'; } // ── Speed label helper ─────────────────────────────────────────────────── function portSpeedLabel(port) { if (!port || !port.up) return ''; const spd = port.speed_mbps; if (!spd) return ''; if (spd >= 10000) return '10G'; if (spd >= 1000) return '1G'; if (spd >= 100) return '100M'; return spd + 'M'; } // Blocks only fit a few characters of the neighbor, so hover text carries it in full function portTitle(port, idx) { if (!port) return `Port ${idx}`; const neighbor = port.lldp && (port.lldp.system_name || port.lldp.chassis_id); return escHtml(neighbor ? `${port.name} → ${neighbor}` : port.name); } function sfpKindLabel(sfp) { if (sfp.kind === 'dac') return 'DAC'; if (sfp.kind === 'optic') return sfp.compliance || 'Optic'; return 'Module'; } function faceplatePortTitle(port, idx, role) { const parts = [role ? `Port ${idx} (${role})` : `Port ${idx}`]; const sfp = port && port.sfp; if (!port || !port.up) { parts.push(sfp && !sfp.found ? 'empty cage' : 'no link'); } else { const speed = portSpeedLabel(port); if (speed) parts.push(speed); if (port.poe_power > 0) parts.push(`${port.poe_power.toFixed(1)} W PoE`); } if (sfp && sfp.found) parts.push(sfp.part ? `${sfpKindLabel(sfp)} ${sfp.part}` : sfpKindLabel(sfp)); if (sfp && (sfp.rx_fault || sfp.tx_fault)) parts.push('module fault'); const neighbor = port && port.lldp && (port.lldp.system_name || port.lldp.chassis_id); if (neighbor) parts.push(`→ ${neighbor}`); return escHtml(parts.join(' · ')); } // ── Cutsheet section of the port panel ────────────────────────────────── const CUTSHEET_PROBLEM = new Set(['wrong_neighbor', 'no_link', 'missing_port', 'conflict']); function cutsheetPanelHtml(swName, idx) { const entries = ((_apiData && _apiData.cutsheet) || []).filter(e => e.port === String(idx)); const head = '
Cutsheet
'; if (!entries.length) { const add = `/cutsheet?a_device=${encodeURIComponent(swName)}&a_port=${encodeURIComponent(idx)}`; return `${head}
Planned Not documented · Add cable
`; } return head + entries.map(e => { const cls = CUTSHEET_PROBLEM.has(e.verdict) ? 'val-crit' : (e.verdict === 'match' ? 'val-good' : 'val-neutral'); const path = (e.path || []).filter(h => !('cable_id' in h)).map(h => escHtml(h.text)).join(' → '); const name = e.label ? escHtml(e.label) : 'unlabeled'; return `
Cable ${name} · ${escHtml(e.status)}
${escHtml(e.detail)}
${path ? `
${path}
` : ''}`; }).join(''); } // The faceplate dot for one port: the worst state of the cables documented on it const MARK_RANK = { bad: 3, doc: 2, ok: 1 }; function cutsheetMarkFor(idx) { const entries = ((_apiData && _apiData.cutsheet) || []).filter(e => e.port === String(idx) && e.status !== 'retired'); if (!entries.length) return null; let best = null; entries.forEach(e => { const mark = CUTSHEET_PROBLEM.has(e.verdict) ? 'bad' : (e.verdict === 'match' ? 'ok' : 'doc'); if (!best || MARK_RANK[mark] > MARK_RANK[best.mark]) { best = { mark, text: `cable ${e.label || 'unlabeled'}: ${e.detail}` }; } }); return best; } document.addEventListener('change', e => { if (!e.target.matches('[data-action="toggle-cutsheet-marks"]')) return; const off = !e.target.checked; document.body.classList.toggle('fp-marks-off', off); try { localStorage.setItem('gandalf.cutsheetMarks', off ? 'off' : 'on'); } catch (_) { /* private mode */ } }); try { if (localStorage.getItem('gandalf.cutsheetMarks') === 'off') document.body.classList.add('fp-marks-off'); } catch (_) { /* private mode */ } // ── SFP module section of the port panel ──────────────────────────────── function sfpPanelHtml(sfp) { if (!sfp) return ''; const row = (label, val, tip) => `
${label}${val}
`; const head = '
SFP Module
'; if (!sfp.found) return head + row('Module', 'Empty cage'); const rows = [row('Type', escHtml(sfpKindLabel(sfp)))]; const model = [sfp.vendor, sfp.part].filter(Boolean).join(' '); if (model) rows.push(row('Part', escHtml(model))); if (sfp.serial) rows.push(row('Serial', escHtml(sfp.serial))); if (sfp.rx_fault || sfp.tx_fault) { const which = [sfp.rx_fault && 'receive', sfp.tx_fault && 'transmit'].filter(Boolean).join(' and '); rows.push(row('Fault', `${which} fault`, 'Flags the module itself raises: receive = loss of signal, transmit = laser fault.')); } if (sfp.rx_power_dbm != null) { rows.push(row('RX power', `${sfp.rx_power_dbm.toFixed(2)} dBm ${renderPowerBar(sfp.rx_power_dbm, -18, -25)}`, 'Light received from the far end')); } if (sfp.tx_power_dbm != null) { rows.push(row('TX power', `${sfp.tx_power_dbm.toFixed(2)} dBm ${renderPowerBar(sfp.tx_power_dbm, -10, -13)}`, 'Light this module sends')); } if (sfp.temperature_c != null) rows.push(row('Temp', `${sfp.temperature_c.toFixed(1)} °C`)); if (sfp.voltage_v != null) rows.push(row('Voltage', `${sfp.voltage_v.toFixed(2)} V`)); if (sfp.current_ma != null) rows.push(row('Bias', `${sfp.current_ma.toFixed(1)} mA`, 'Laser bias current')); if (sfp.kind === 'dac' && sfp.rx_power_dbm == null) { rows.push(row('Readings', 'None: copper DACs have no optics')); } const peer = sfp.cable_peer; if (peer) { const href = `${deviceUrl(peer.switch)}#port-${encodeURIComponent(peer.port_idx)}`; rows.push(row('Other end', `${escHtml(peer.switch)} port ${escHtml(String(peer.port_idx))}`, 'Both ends of this DAC report the same cable serial')); } return head + rows.join(''); } // Faceplate jacks are too small for text, so one line under the panel names // the hovered or selected port. function updateFaceplateReadout(el) { const readout = document.getElementById('fp-readout'); if (!readout) return; const target = el || document.querySelector('.fp-port.selected'); const title = target && target.getAttribute('aria-label'); readout.textContent = title || (document.querySelector('.fp-outlet') ? 'Hover or select an outlet or port' : 'Hover or select a port'); } // ── Render a single port block element ────────────────────────────────── function portBlockHtml(idx, port, swName, sfpBlock) { const state = portBlockState(port); const numLabel = sfpBlock ? 'SFP' : idx; const title = portTitle(port, idx); const sfpCls = sfpBlock ? ' sfp-block' : ''; const speedTxt = portSpeedLabel(port); // LLDP neighbor: first 6 chars of hostname const lldpName = (port && port.lldp && (port.lldp.system_name || port.lldp.chassis_id)) ? escHtml((port.lldp.system_name || port.lldp.chassis_id || '').slice(0, 6)) : ''; const lldpHtml = lldpName ? `${lldpName}` : ''; const speedHtml = speedTxt ? `${speedTxt}` : ''; return `
${numLabel}${speedHtml}${lldpHtml}
`; } // ── Chassis legend HTML ────────────────────────────────────────────────── function chassisLegendHtml() { return `
down
up
poe active
uplink
`; } // ── Render one switch chassis ──────────────────────────────────────────── function renderChassis(swName, sw) { const model = sw.model || ''; const portMap = buildPortIdxMap(sw.ports || {}); const ports = Object.entries(sw.ports || {}); const upCount = ports.filter(([, p]) => p.up).length; const downCount = ports.length - upCount; const counts = ports.length ? [`${upCount}/${ports.length} up`, downCount ? `${downCount} down` : ''] : []; const meta = [model, ...counts].filter(Boolean).join(' · '); const header = `
Front panel ${escHtml(meta)}
`; if (FACEPLATES[model]) { return `
${header}${renderFaceplate(model, { swName, portMap, outlets: sw.outlets, online: sw.online, titleFor: faceplatePortTitle, cutsheetFor: cutsheetMarkFor, })}
`; } // No faceplate for this model yet: plain blocks in port order const blocks = ports .sort(([, a], [, b]) => (a.port_idx || 0) - (b.port_idx || 0)) .map(([pname, d]) => portBlockHtml(d.port_idx || 0, Object.assign({ name: pname }, d), swName, false)) .join(''); return `
${header}
${blocks}
${chassisLegendHtml()}
`; } // ── State ──────────────────────────────────────────────────────────────── let _selectedSwitch = null; let _selectedIdx = null; let _apiData = null; let _diagPollTimer = null; // ── Port selection ─────────────────────────────────────────────────────── function selectPort(el) { selectPortByIdx(el.dataset.switch, parseInt(el.dataset.portIdx, 10)); } function selectPortByIdx(swName, idx) { const sw = _apiData && _apiData.unifi_switches[swName]; if (!sw || !buildPortIdxMap(sw.ports || {})[idx]) return; if (_diagPollTimer) { clearInterval(_diagPollTimer); _diagPollTimer = null; } _selectedSwitch = swName; _selectedIdx = idx; renderPanel(swName, idx); highlightSelectedPort(); history.replaceState(null, '', `#port-${idx}`); // On narrow screens the panel sits below the front panel, possibly off screen if (window.matchMedia('(max-width: 900px)').matches) { document.getElementById('inspector-panel').scrollIntoView({ behavior: 'smooth', block: 'nearest' }); } } function closePanel() { if (_diagPollTimer) { clearInterval(_diagPollTimer); _diagPollTimer = null; } document.getElementById('inspector-panel').classList.remove('open'); _selectedSwitch = null; _selectedIdx = null; highlightSelectedPort(); history.replaceState(null, '', window.location.pathname + window.location.search); } // ── Render detail panel ────────────────────────────────────────────────── function renderPanel(swName, idx) { if (!_apiData) return; const sw = _apiData.unifi_switches && _apiData.unifi_switches[swName]; if (!sw) return; const portMap = buildPortIdxMap(sw.ports || {}); const d = portMap[idx]; if (!d) return; const upStr = d.up ? 'UP' : 'DOWN'; const speedStr = d.speed_mbps ? `${fmtShortSpeed(d.speed_mbps)}bps` : '-'; const duplexCls = d.full_duplex ? 'val-good' : (d.up ? 'val-warn' : 'val-neutral'); const duplexStr = d.up ? `${d.full_duplex ? 'Full' : 'Half'}` : '-'; const autoneg = d.autoneg ? 'On' : 'Off'; const mediaStr = d.media || '-'; const isUplinkBadge = d.is_uplink ? ' UPLINK' : ''; // PoE section let poeHtml = ''; if (d.poe_power || d.poe_max_power) { const poeMaxStr = d.poe_max_power != null ? ` / max ${d.poe_max_power.toFixed(1)}W` : ''; poeHtml = `
PoE
Classclass ${escHtml(String(d.poe_class))}${poeMaxStr}
${d.poe_power != null ? `
Draw${d.poe_power > 0 ? `${d.poe_power.toFixed(1)}W` : '0W'}
` : ''} ${d.poe_mode ? `
Mode${escHtml(d.poe_mode)}
` : ''}`; } // Traffic section let trafficHtml = ''; if (d.tx_bytes_rate != null || d.rx_bytes_rate != null) { trafficHtml = `
Traffic
TX${fmtRate(d.tx_bytes_rate)}
RX${fmtRate(d.rx_bytes_rate)}
`; } // Errors / drops section let errHtml = ''; if (d.tx_errs_rate != null || d.rx_errs_rate != null) { errHtml = `
Errors / Drops
TX Err${fmtErrors(d.tx_errs_rate)}
RX Err${fmtErrors(d.rx_errs_rate)}
TX Drop${fmtErrors(d.tx_drops_rate)}
RX Drop${fmtErrors(d.rx_drops_rate)}
`; } // LLDP + path debug let lldpHtml = ''; let pathHtml = ''; if (d.lldp) { const l = d.lldp; lldpHtml = `
${l.source === 'unifi-clients' ? 'Neighbor (UniFi client table)' : 'LLDP Neighbor'}
${l.system_name ? `
System${escHtml(l.system_name)}
` : ''} ${l.port_id ? `
Port${escHtml(l.port_id)}
` : ''} ${l.port_desc ? `
Port Desc${escHtml(l.port_desc)}
` : ''} ${l.chassis_id ? `
Chassis${escHtml(l.chassis_id)}
` : ''} ${l.mgmt_ips && l.mgmt_ips.length ? `
Mgmt IP${escHtml(l.mgmt_ips.join(', '))}
` : ''}`; // Path debug: look for matching server interface const hosts = _apiData.hosts || {}; const serverIfaces = hosts[l.system_name]; if (serverIfaces) { let matchedIface = l.port_id && serverIfaces[l.port_id] ? l.port_id : null; if (!matchedIface && l.port_id) { // fuzzy match matchedIface = Object.keys(serverIfaces).find(k => l.port_id.includes(k) || k.includes(l.port_id)) || null; } if (matchedIface) { pathHtml = buildPathDebug(swName, d, l.system_name, matchedIface, serverIfaces[matchedIface]); } } } // Diagnose button (only when LLDP has an identified neighbor we can map) const hasDiagTarget = !!(d.lldp && d.lldp.system_name && _apiData.hosts && _apiData.hosts[d.lldp.system_name]); const diagHtml = hasDiagTarget ? `
` : ''; // Auto-refresh re-renders this panel. A running poll holds these elements, // and results may be on screen, so carry them over for the same port. const inner = document.getElementById('inspector-panel-inner'); const panelKey = `${swName}#${idx}`; const samePort = inner.dataset.port === panelKey; const keptStatus = samePort ? document.getElementById('diag-status') : null; const keptResults = samePort ? document.getElementById('diag-results') : null; const scrollTop = samePort ? inner.scrollTop : 0; inner.dataset.port = panelKey; inner.innerHTML = `
${escHtml(d.name)}${isUplinkBadge}
${escHtml(swName)} · port #${idx}
Link
Status${upStr}
Speed${speedStr}
Duplex${duplexStr}
Auto-neg${autoneg}
Media${escHtml(mediaStr)}
${cutsheetPanelHtml(swName, idx)} ${sfpPanelHtml(d.sfp)} ${poeHtml} ${trafficHtml} ${errHtml} ${lldpHtml} ${pathHtml} ${diagHtml} `; if (keptStatus) document.getElementById('diag-status')?.replaceWith(keptStatus); if (keptResults) document.getElementById('diag-results')?.replaceWith(keptResults); inner.scrollTop = scrollTop; document.getElementById('inspector-panel').classList.add('open'); } // ── Build path debug two-column section ───────────────────────────────── function buildPathDebug(swName, swPort, serverName, ifaceName, svrData) { const isFiber = (swPort.media || '').toLowerCase().includes('sfp') || (svrData.port_type || '').toLowerCase().includes('fibre') || (svrData.port_type || '').toLowerCase().includes('fiber') || !!svrData.sfp; const connType = isFiber ? 'SFP / Fiber' : 'Copper'; let sfpDomHtml = ''; if (svrData.sfp && Object.keys(svrData.sfp).length) { const sfp = svrData.sfp; sfpDomHtml = '
'; if (sfp.vendor) sfpDomHtml += `
Vendor${escHtml(sfp.vendor)}${sfp.part_no ? ' / ' + escHtml(sfp.part_no) : ''}
`; if (sfp.temp_c != null) sfpDomHtml += `
Temp${sfp.temp_c.toFixed(1)}°C
`; if (sfp.tx_power_dbm != null) sfpDomHtml += `
TX${sfp.tx_power_dbm.toFixed(2)} dBm
`; if (sfp.rx_power_dbm != null) sfpDomHtml += `
RX${sfp.rx_power_dbm.toFixed(2)} dBm
`; sfpDomHtml += '
'; } const svrErrTx = (svrData.tx_errs_rate > 0.001) ? 'val-crit' : 'val-good'; const svrErrRx = (svrData.rx_errs_rate > 0.001) ? 'val-crit' : 'val-good'; const swErrTx = (swPort.tx_errs_rate > 0.001) ? 'val-crit' : 'val-good'; const swErrRx = (swPort.rx_errs_rate > 0.001) ? 'val-crit' : 'val-good'; // Detect duplex mismatch (switch full_duplex vs server duplex string) const swFull = swPort.full_duplex; const svrFull = (svrData.duplex || '').toLowerCase().includes('full'); const duplexMismatch = swPort.up && svrData.duplex && ((swFull && !svrFull) || (!swFull && svrFull)); const duplexWarnHtml = duplexMismatch ? `
⚠ DUPLEX MISMATCH. Switch: ${swFull ? 'Full' : 'Half'} · Server: ${escHtml(svrData.duplex)}
` : ''; // Detect speed mismatch const swSpd = swPort.speed_mbps, svrSpd = svrData.speed_mbps; const speedMismatch = swSpd && svrSpd && swSpd > 0 && svrSpd > 0 && swSpd !== svrSpd; const speedWarnHtml = speedMismatch ? `
⚠ SPEED MISMATCH. Switch: ${fmtShortSpeed(swSpd)} · Server: ${fmtShortSpeed(svrSpd)}
` : ''; return `
Path Debug · ${escHtml(connType)}
${duplexWarnHtml}${speedWarnHtml}
Switch
Port${escHtml(swPort.name)}
Speed${fmtShortSpeed(swPort.speed_mbps)}bps
TX${fmtRate(swPort.tx_bytes_rate)}
RX${fmtRate(swPort.rx_bytes_rate)}
TX Err${fmtErrors(swPort.tx_errs_rate)}
RX Err${fmtErrors(swPort.rx_errs_rate)}
${(swPort.poe_power != null && swPort.poe_power > 0) ? `
PoE${swPort.poe_power.toFixed(1)}W
` : ''}
Server: ${escHtml(serverName)}
Iface${escHtml(ifaceName)}
Speed${svrData.speed_mbps ? fmtShortSpeed(svrData.speed_mbps) + 'bps' : '-'}
TX${fmtRate(svrData.tx_bytes_rate)}
RX${fmtRate(svrData.rx_bytes_rate)}
TX Err${fmtErrors(svrData.tx_errs_rate)}
RX Err${fmtErrors(svrData.rx_errs_rate)}
${svrData.carrier_changes != null ? `
Carrier Chg${svrData.carrier_changes}
` : ''} ${sfpDomHtml}
`; } // ── Page integration: device.js supplies this one device's data ────────── function renderPortInspector(detail) { _apiData = { unifi_switches: { [detail.name]: { ip: detail.ip, model: detail.model, ports: detail.ports || {}, outlets: detail.info && detail.info.outlets, online: detail.status === 'up', } }, hosts: detail.neighbor_hosts || {}, cutsheet: detail.cutsheet || [], }; const chassis = document.getElementById('device-chassis'); // Auto-refresh redraws the panel, so keep a scrolled panel where the user left it const oldFrame = chassis.querySelector('.fp-scroll'); const scrollLeft = oldFrame ? oldFrame.scrollLeft : null; chassis.innerHTML = renderChassis(detail.name, _apiData.unifi_switches[detail.name]); const frame = chassis.querySelector('.fp-scroll'); if (frame) frame.scrollLeft = scrollLeft !== null ? scrollLeft : faceplateScrollLeft(detail.model, frame); if (_selectedSwitch === detail.name && _selectedIdx !== null) { renderPanel(_selectedSwitch, _selectedIdx); } else if (_selectedSwitch === null) { openPortFromHash(detail.name); } highlightSelectedPort(); } function openPortFromHash(swName) { const m = /^#port-(\d+)$/.exec(window.location.hash); if (m) selectPortByIdx(swName, parseInt(m[1], 10)); } function highlightSelectedPort() { document.querySelectorAll('[data-action="select-port"]').forEach(el => { el.classList.toggle('selected', parseInt(el.dataset.portIdx, 10) === _selectedIdx); }); updateFaceplateReadout(); document.querySelectorAll('tr.device-row[data-port-idx]').forEach(row => { row.classList.toggle('is-selected', parseInt(row.dataset.portIdx, 10) === _selectedIdx); }); } document.addEventListener('keydown', e => { if (e.key === 'Escape' && document.getElementById('inspector-panel').classList.contains('open')) { closePanel(); return; } if (e.key !== 'Enter' && e.key !== ' ') return; const block = e.target.closest('[data-action="select-port"]'); if (block) { e.preventDefault(); selectPort(block); } }); document.addEventListener('mouseover', e => { const port = e.target.closest && e.target.closest('.fp-port, .fp-outlet'); if (port) updateFaceplateReadout(port); }); document.addEventListener('mouseout', e => { if (e.target.closest && e.target.closest('.fp-port, .fp-outlet')) updateFaceplateReadout(); }); document.addEventListener('focusin', e => { const port = e.target.closest && e.target.closest('.fp-port, .fp-outlet'); if (port) updateFaceplateReadout(port); }); document.addEventListener('click', e => { const portBlock = e.target.closest('[data-action="select-port"]'); if (portBlock) { selectPort(portBlock); return; } const closeBtn = e.target.closest('[data-action="close-panel"]'); if (closeBtn) { closePanel(); return; } const diagBtn = e.target.closest('[data-action="run-diagnostic"]'); if (diagBtn) { runDiagnostic(diagBtn.dataset.sw, parseInt(diagBtn.dataset.idx, 10)); return; } const toggleDiag = e.target.closest('[data-action="toggle-diag"]'); if (toggleDiag) { const section = toggleDiag.parentElement; const nowOpen = section.classList.toggle('diag-open'); const hint = toggleDiag.querySelector('.diag-toggle-hint'); if (hint) hint.textContent = nowOpen ? '[collapse]' : '[expand]'; return; } }); // ── Link Diagnostics ───────────────────────────────────────────────── function runDiagnostic(swName, portIdx) { const statusEl = document.getElementById('diag-status'); const resultsEl = document.getElementById('diag-results'); if (!statusEl || !resultsEl) return; // Clear any previous poll if (_diagPollTimer) { clearInterval(_diagPollTimer); _diagPollTimer = null; } statusEl.textContent = 'Submitting to Pulse...'; resultsEl.innerHTML = ''; lt.api.post('/api/diagnose', {switch_name: swName, port_idx: portIdx}) .then(resp => { statusEl.textContent = 'Collecting diagnostics via Pulse...'; pollDiagnostic(resp.job_id, statusEl, resultsEl); }) .catch(e => { const msg = (e && e.status === 429) ? 'Rate limit reached: max 5 diagnostics per minute. Please wait.' : 'Error: ' + (e && e.message || 'Request failed'); statusEl.textContent = msg; }); } function pollDiagnostic(jobId, statusEl, resultsEl) { let attempts = 0; _diagPollTimer = setInterval(() => { attempts++; if (attempts > 120) { // 2min timeout clearInterval(_diagPollTimer); _diagPollTimer = null; statusEl.innerHTML = 'Timed out waiting for results. ' + ''; document.getElementById('diag-retry-btn')?.addEventListener('click', () => { const sel = document.querySelector('[data-action="select-port"].selected'); if (sel) runDiagnostic(sel.dataset.switch, parseInt(sel.dataset.portIdx)); }); return; } lt.api.get(`/api/diagnose/${jobId}`) .then(resp => { if (resp.status === 'done') { clearInterval(_diagPollTimer); _diagPollTimer = null; statusEl.textContent = ''; renderDiagnosticResults(resp.result, resultsEl); } }) .catch(() => { clearInterval(_diagPollTimer); _diagPollTimer = null; statusEl.innerHTML = 'Error: lost connection while collecting diagnostics. ' + ''; document.getElementById('diag-retry-btn')?.addEventListener('click', () => { const sel = document.querySelector('[data-action="select-port"].selected'); if (sel) runDiagnostic(sel.dataset.switch, parseInt(sel.dataset.portIdx)); }); }); }, 2000); } function renderDiagnosticResults(d, container) { if (!d || d.status === 'error') { container.innerHTML = `
Diagnostic error: ${escHtml((d && d.error) || 'unknown')}
`; return; } const health = d.health || {}; const issues = health.issues || []; const warns = health.warnings || []; const infoArr = health.info || []; const secs = d.sections || {}; const eth = secs.ethtool || {}; const drv = secs.ethtool_driver || {}; const pause = secs.ethtool_pause || {}; const ring = secs.ethtool_ring || {}; const dom = secs.ethtool_dom || {}; const sysfs = secs.sysfs_stats || {}; const dmesg = secs.dmesg || []; const lldpctl = secs.lldpctl || {}; const nicStats = secs.ethtool_stats || {}; const swPort = d.switch_port || {}; // ── Health banner ── let bannerHtml = ''; if (issues.length === 0 && warns.length === 0) { bannerHtml = '
ALL OK
'; } else { const parts = []; if (issues.length) parts.push(`${issues.length} CRITICAL`); if (warns.length) parts.push(`${warns.length} WARNING`); bannerHtml = `
${parts.join(' ')}
`; } const issueRows = [...issues, ...warns, ...infoArr].map(item => { const cls = issues.includes(item) ? 'diag-val-bad' : warns.includes(item) ? 'diag-val-warn' : 'diag-val-good'; const label = issues.includes(item) ? 'CRIT' : warns.includes(item) ? 'WARN' : 'INFO'; return `
[${label}] ${escHtml(item.code)}: ${escHtml(item.message)}
`; }).join(''); // ── Physical layer ── const carrierVal = secs.carrier === '1' ? 'YES' : secs.carrier === '0' ? 'NO' : '-'; const operstateVal = (secs.operstate || '?').toUpperCase(); const opstateCls = secs.operstate === 'up' ? 'diag-val-good' : secs.operstate === 'down' ? 'diag-val-bad' : 'diag-val-warn'; const speedVal = eth.speed_mbps ? `${fmtShortSpeed(eth.speed_mbps)}bps` : '-'; const duplexVal = eth.duplex === 'full' ? 'Full' : eth.duplex === 'half' ? 'Half' : '-'; const linkDetVal = eth.link_detected === true ? 'Yes' : eth.link_detected === false ? 'No' : '-'; const autonegVal = eth.auto_neg === true ? 'On' : eth.auto_neg === false ? 'Off' : '-'; const physHtml = `
Physical Layer
${secs.carrier_changes != null ? `` : ''}
Carrier${carrierVal}
Oper State${escHtml(operstateVal)}
Speed${speedVal}
Duplex${duplexVal}
Link Detected${linkDetVal}
Auto-neg${autonegVal}
Carrier Changes${secs.carrier_changes}
`; // ── SFP / DOM ── let domHtml = ''; if (dom && Object.keys(dom).length > 0) { const rxBar = dom.rx_power_dbm != null ? renderPowerBar(dom.rx_power_dbm, -18, -25) : ''; const txBar = dom.tx_power_dbm != null ? renderPowerBar(dom.tx_power_dbm, -10, -13) : ''; domHtml = `
SFP / DOM
${dom.vendor ? `` : ''} ${dom.sfp_type ? `` : ''} ${dom.connector ? `` : ''} ${dom.wavelength_nm != null ? `` : ''} ${dom.temp_c != null ? `` : ''} ${dom.voltage_v != null ? `` : ''} ${dom.bias_ma != null ? `` : ''} ${dom.tx_power_dbm != null ? `` : ''} ${dom.rx_power_dbm != null ? `` : ''}
Vendor${escHtml(dom.vendor)}${dom.part_no ? ' / ' + escHtml(dom.part_no) : ''}
Type${escHtml(dom.sfp_type)}
Connector${escHtml(dom.connector)}
Wavelength${dom.wavelength_nm} nm
Temperature${dom.temp_c.toFixed(1)} °C
Voltage${dom.voltage_v.toFixed(4)} V
Bias Current${dom.bias_ma.toFixed(3)} mA
TX Power${dom.tx_power_dbm.toFixed(2)} dBm ${txBar}
RX Power${dom.rx_power_dbm.toFixed(2)} dBm ${rxBar}
`; } // ── NIC Error Counters ── const errCounters = ['rx_crc_errors','rx_frame_errors','collisions','tx_carrier_errors','rx_missed_errors','rx_fifo_errors']; const nonZeroCounters = errCounters.filter(k => sysfs[k] > 0); let errCounterHtml = ''; if (nonZeroCounters.length > 0 || secs.carrier_changes > 0) { const rows = nonZeroCounters.map(k => { const v = sysfs[k]; const cls = v > 100 ? 'diag-val-bad' : 'diag-val-warn'; return `${escHtml(k)}${v.toLocaleString()}`; }).join(''); errCounterHtml = `
NIC Error Counters
${rows || ''}
All zero
`; } // ── ethtool -S (collapsible) ── let nicStatHtml = ''; if (Object.keys(nicStats).length > 0) { const _ERR_KEYS = /err|drop|miss|crc|frame|fifo|abort|carrier|collision|fault|discard|overflow|reset/i; const rows = Object.entries(nicStats).map(([k, v]) => { const cls = _ERR_KEYS.test(k) && v > 0 ? ' class="diag-stat-nonzero-warn"' : ''; return `${escHtml(k)}${v.toLocaleString()}`; }).join(''); nicStatHtml = `
ethtool -S (NIC stats) [expand]
${rows}
`; } // ── Flow Control + Ring Buffers ── let flowRingHtml = ''; const hasPause = Object.keys(pause).length > 0; const hasRing = Object.keys(ring).length > 0; if (hasPause || hasRing) { flowRingHtml = `
Flow Control & Ring Buffers
${hasPause ? ` ` : ''} ${hasRing ? ` ` : ''}
RX Pause${pause.rx_pause ? 'On' : 'Off'}
TX Pause${pause.tx_pause ? 'On' : 'Off'}
RX Ring${ring.rx_current != null ? ring.rx_current : '-'} / ${ring.rx_max != null ? ring.rx_max : '-'} max
TX Ring${ring.tx_current != null ? ring.tx_current : '-'} / ${ring.tx_max != null ? ring.tx_max : '-'} max
`; } // ── Driver Info ── let drvHtml = ''; if (Object.keys(drv).length > 0) { drvHtml = `
Driver Info
${drv.driver ? `` : ''} ${drv.version ? `` : ''} ${drv.firmware_version ? `` : ''} ${drv.bus_info ? `` : ''}
Driver${escHtml(drv.driver)}
Version${escHtml(drv.version)}
Firmware${escHtml(drv.firmware_version)}
Bus${escHtml(drv.bus_info)}
`; } // ── LLDP Validation ── let lldpValHtml = ''; const swLldp = swPort.lldp || {}; lldpValHtml = `
LLDP Validation
Switch sees
System${escHtml(swLldp.system_name || '-')}
Port${escHtml(swLldp.port_id || '-')}
Chassis${escHtml(swLldp.chassis_id || '-')}
Server lldpctl
${lldpctl.available ? `
Neighbor${escHtml(lldpctl.neighbor_system || '-')}
Port${escHtml(lldpctl.neighbor_port || '-')}
` : '
lldpd not running
'}
`; // ── dmesg ── let dmesgHtml = ''; if (dmesg.length > 0) { const dlines = dmesg.map(e => { const cls = e.severity === 'error' ? ' diag-dmesg-err' : e.severity === 'warn' ? ' diag-dmesg-warn' : ''; const ts = e.timestamp ? `[${e.timestamp}] ` : ''; return `
${escHtml(ts + e.msg)}
`; }).join(''); dmesgHtml = `
Kernel Events (dmesg) [expand]
${dlines}
`; } // ── Switch Port Summary ── const swSummaryHtml = `
Switch Port Summary
${swPort.poe_power != null ? `` : ''}
Status${swPort.up ? 'UP' : 'DOWN'}
Speed${swPort.speed_mbps ? fmtShortSpeed(swPort.speed_mbps) + 'bps' : '-'}
Duplex${swPort.full_duplex ? 'Full' : (swPort.up ? 'Half' : '-')}
TX Err${fmtErrors(swPort.tx_errs_rate)}
RX Err${fmtErrors(swPort.rx_errs_rate)}
PoE${swPort.poe_power.toFixed(1)}W
`; // ── Pulse link ── const pulseLink = d.pulse_url ? `` : ''; container.innerHTML = `
${bannerHtml}
${issueRows}
${physHtml} ${domHtml} ${errCounterHtml} ${nicStatHtml} ${flowRingHtml} ${drvHtml} ${lldpValHtml} ${dmesgHtml} ${swSummaryHtml} ${pulseLink}
`; } // SFP power bar: range is 0 dBm (best) to -35 dBm (worst) function renderPowerBar(dbm, warnThreshold, critThreshold) { const minDbm = -35, maxDbm = 0; const pct = Math.max(0, Math.min(100, ((dbm - minDbm) / (maxDbm - minDbm)) * 100)); const warnPct = ((warnThreshold - minDbm) / (maxDbm - minDbm)) * 100; const critPct = ((critThreshold - minDbm) / (maxDbm - minDbm)) * 100; const barCls = dbm < critThreshold ? 'diag-val-bad' : dbm < warnThreshold ? 'diag-val-warn' : 'diag-val-good'; return ` `; }