Support Console

The Support Console is an on-device troubleshooting overlay for store associates and technicians. It surfaces device health and quick-recovery actions without requiring administrative access or a remote support session.

This page covers what the panel shows and how each section is driven by configuration. For the full field reference, see Technical Guide → emsSupportTool.

Opening the Panel

A System Information icon sits in the taskbar next to the clock. Clicking it toggles a popup anchored to the bottom-right of the screen; clicking outside the popup, or the icon again, closes it.

Sections

The panel renders up to four sections, top to bottom. A section is omitted entirely if it has nothing configured to show.

1. Help

Rendered only when emsSupportTool.helpInfo.entries has at least one entry. Each entry renders one of two ways:

• { "label", "value" } — a static display row (e.g. a phone number or site code).

• { "label", "url" } — a clickable link that opens in the device's default browser.

The section heading comes from helpInfo.helpLabel (default "Help").

2. Services & Processes

Rendered only when at least one configured service or process returns a status. The section heading comes from systemMonitoring.servicesLabel (default "Services & Processes").

Each monitored service shows its Windows display name and a colored status (Running in green; Stopped/Paused/other in red or gray). A Restart button appears whenever the status is Stopped or Paused:

• If the service entry has a restart path, that script/executable/shortcut runs.

• Otherwise, a built-in PowerShell script restarts the Windows service directly by its service name.

Each monitored process shows its configured name and status (Running / NotRunning). Unlike services, a process's Restart button appears only when the process is Stopped and a restart path is configured — there's no generic way to relaunch an arbitrary process without knowing how to start it, so processes have no built-in fallback.

After any successful restart, both lists refresh immediately so the new status is visible right away.

3. Network Info

Always rendered (shows a "No network information available" message if empty). One card per network adapter, showing Connection Type, IP Address, and MAC Address.

4. Computer Info

Always rendered (shows a failure message if the underlying script didn't return data). Shows Name, Manufacturer, Model, Serial, and Uptime.

Configuring Its Content

Everything except Network Info and Computer Info (which are always gathered automatically) is driven by the emsSupportTool block in launcher.json:

Key	Description
helpInfo.helpLabel	Heading text for the Help section.
helpInfo.entries	Array of { label, value } or { label, url } entries — see Help above.
systemMonitoring.servicesLabel	Heading text for the Services & Processes section.
systemMonitoring.services	Array of { name, restart? }. name must be the Windows service name, not its display name (e.g. wuauserv, not "Windows Update").
systemMonitoring.processes	Array of { name, restart? }. name is the process image name without .exe. A restart path is required for the Restart button to appear.

"emsSupportTool": {
  "orgId": "<YOUR-ORG-ID>",
  "eventUrl": "https://ems-services-api.bluefletch.com/eventsAPI/apiv1/event",
  "systemMonitoring": {
    "servicesLabel": "POS Components",
    "services": [
      { "name": "wuauserv" },
      { "name": "EventLog", "restart": "C:\\ProgramData\\BlueFletch\\scripts\\restart_eventlog.ps1" }
    ],
    "processes": [
      { "name": "chrome", "restart": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe" },
      { "name": "notepad" }
    ]
  },
  "helpInfo": {
    "helpLabel": "Service Desk",
    "entries": [
      { "label": "Desk Phone", "value": "555-1234" },
      { "label": "Submit a Ticket", "url": "https://support.example.com/submit" }
    ]
  }
}

In this example, notepad is monitored (its status shows in the panel) but has no Restart button, since it has no restart path configured.

orgId and eventUrl are mandatory on emsSupportTool even if you don't use systemMonitoring or helpInfo — they're also used for EMS login/logout event reporting and Central Auth. See Configuration Structure → emsSupportTool.