Troubleshooting NetworkVantage
Runbook for everyone · reviewed 22 November 2026Configure
- Logging is always on. Every page keeps its events (pages opened, errors, warnings) in this browser, the last 400, and errors go to the shared log engineers search on Diagnostics. Passwords, keys and tokens are removed first.
- Debug mode logs every page open, click and data load. Turn it on at Diagnostics → Debug mode (1, 4 or 24 hours) or add
?debug=1to any address. A purple Debug on badge shows while it runs; it ends by itself after 24 hours. - Feature switches: NetworkVantage (
app.vantage), Report a problem (app.vantage.report), the yellow tour (app.vantage.tour) and Diagnostics (app.vantage.diag) can each be turned off by an admin in the moretechlabs.com admin portal. They readfiles/feature-switches.jsonon this site and the portal's setting in the same browser. - Report a problem sits at the bottom left of every page (Alt+Shift+R). On this demo a report is kept in the browser and downloaded as a file to attach to a ticket; a live install sends it to the support queue.
Troubleshoot
| What you see | Do this | Code |
|---|---|---|
| A page is blank or a button does nothing | Reload. Then Diagnostics → Clear cache. | NV-101 |
| A site shows old times ("collected 3 hours ago") | App status → Quiet sites. The site's page says what failed. | NV-106 |
| Maps or tables are missing | Diagnostics → Re-sync data, then reload. | NV-102 |
| The colour scheme or View as resets on every page | Allow site data for this address; leave private browsing. | NV-103 |
| A bookmark says the page does not exist | Open it from the left menu or Find. | NV-104 |
| Folds, the menu or cards look squashed | Diagnostics → Reset layout. | NV-110 |
| Ask Vantage says it cannot answer | Wait a minute; there is a daily limit. | NV-107 |
| The yellow tour button or Report a problem has gone | An admin turned it off in Feature switches. | NV-109 |
Diagnose
- Open Diagnostics. Red lights under This browser point at the browser; red under Health checks points at the collector or a site.
- Search the Error log for the code or the page. The same code from several users means the site, not the browser.
- Turn on Debug mode, repeat what went wrong, then Download support bundle. It holds the log, the checks, the browser details and the settings, with secrets removed.
- An engineer opens that file under Remote assist on Diagnostics to see exactly what the person saw, read-only.
- In the browser console,
MTLDiag.entries()lists the log andMTLDiag.checks()the lights.
What goes in a ticket: the code, the page, the time, and the support bundle or problem report file. Never a password, a key or a screenshot of one.
Pass it to an engineer when the same code comes from several people, every site is quiet, or a data file fails for everyone.
Error codes
- NV-101 Something on this page stopped working
- NV-102 A data file did not load
- NV-103 This browser is not keeping settings
- NV-104 That page does not exist
- NV-105 A background task failed
- NV-106 The data is older than it should be
- NV-107 Ask Vantage could not answer
- NV-108 The browser blocked part of the page
- NV-109 An admin has turned this off
- NV-110 The page looks wrong or will not lay out
NV-101 Something on this page stopped working
A script on the page hit an error it could not handle, so part of the page may be blank or a button may do nothing.
Quick fix: Reload the page. If it happens again, press Report a problem.
- Reload the page (F5, or pull down on a phone).
- Still broken: Diagnostics → Clear cache, which reloads the page fresh.
- Still broken: Report a problem on that page. The log line with NV-101 and the script name goes with it.
NV-102 A data file did not load
The page asked the site for one of its data files (status, health, topology) and did not get it.
Quick fix: Open Diagnostics and press Re-sync data. If it still fails, check the network connection.
- Check the browser is online (Diagnostics → Online should be green).
- Diagnostics → Re-sync data fetches every data file again and lists any that fail.
- If one file fails for everyone, the last build did not finish: pass it to an engineer with the file name.
NV-103 This browser is not keeping settings
The browser refuses to store anything for this site, so the colour scheme, View as and the log are lost on every page.
Quick fix: Allow site data for this address, or leave private browsing, then reload.
- Leave private or incognito browsing.
- In the browser's site settings, allow cookies and site data for this address.
- Diagnostics → Browser storage turns green when it works.
NV-104 That page does not exist
The address points to a page that is not on this site: an old bookmark, a typing mistake, or a page an admin has hidden.
Quick fix: Use the menu on the left or Find. An old bookmark may point to a page that was renamed.
- Open the page from the menu on the left instead of the bookmark.
- Use Find for a device, site or address.
- If a page you used yesterday is gone, ask an admin: they may have hidden its module on Core functions.
NV-105 A background task failed
Something the page does in the background (a refresh, a copy, a download) failed without a visible error.
Quick fix: Reload the page. If it repeats, press Report a problem so the log goes with it.
- Reload the page and try again.
- If it repeats, Report a problem straight away, so the log still holds the failure.
NV-106 The data is older than it should be
A site, or the whole collector, has not sent a collection for more than two hours. The alert e-mail goes to on-call.
Quick fix: The collector has gone quiet. Check Collector problems and the site on Health.
- App status shows which sites are quiet and for how long.
- Open the site's page: it says what failed first (Philadelphia on this demo is down on purpose).
- If every site is quiet, the collector itself has stopped: pass it to an engineer with the time it went quiet.
NV-107 Ask Vantage could not answer
The question did not get an answer: the daily limit was reached, or the answer service was busy.
Quick fix: Try again in a minute. The demo answers 60 questions a day for everyone.
- Wait a minute and ask again.
- After the daily limit the next answers come the following day.
- Ask Vantage only reads and explains; nothing on the network changed.
NV-108 The browser blocked part of the page
The site's security policy stopped something from loading, most often a browser extension adding its own script.
Quick fix: Clear the cache on Diagnostics and reload. An extension may be changing the page.
- Diagnostics → Clear cache.
- Try a private window, which starts without extensions.
- If it only happens with one extension, that extension is the cause; the site is fine.
NV-109 An admin has turned this off
An admin turned NetworkVantage, or one part of it (Report a problem, the tour, Diagnostics), off in the moretechlabs.com admin portal.
Quick fix: Ask an admin to turn it back on in Admin portal, Feature switches.
- Ask an admin. They turn it back on in Admin portal → Feature switches → Client sites and tools → Vantage demo.
- It comes back on the next page you open.
NV-110 The page looks wrong or will not lay out
Saved layout settings (folds, the menu width, card size) no longer fit the page, so it looks squashed or out of order.
Quick fix: Press Reset layout on Diagnostics. Your colour scheme is kept.
- Diagnostics → Reset layout. Colour scheme, style and View as are kept.
- Then reload the page.