Skip to content

Log files

Log type... Used for...
Application Logs For identifying disruptions to the service. These are helpful if the service has installed, and the service is not behaving as expected
Installer/MSI Logs For identifying issues with installation and updates. If the service is already installed, these logs don’t add value to any troubleshooting
Event viewer For identifying other applications or events occurring on the server that may have interfered with or disrupted Halo Link, thus preventing the service from properly starting, or stopping. Paired with Event viewer application Logs
Terminal Logs For identifying things that are preventing the service from running and writing logs about its fault. This is often a last resort if the applications logs aren’t present, and the event viewer logs don’t provide adequate insight.

Application logs

Halo Link is installed like any general Windows application and has an installation directory under C:\Program Files (x86)\Halo Connect\Halo Link\. The log files can be found under the folder logs.

An example log file:

[INF] Starting Halo Link Service
[INF] Version: 1.2211.184.0
[DBG] LocalConfig.DbHostname .\BPSINSTANCE
[DBG] LocalConfig.ApiTarget Local
[DBG] LocalConfig.SiteEndpoint
[DBG] LocalConfig.OnboardingEndpoint
[DBG] LocalEnvironment.CurrentDirectory C:\Program Files (x86)\Halo Connect\Halo Link.
[INF] Service starting...
[INF] Opening new session.
[INF] Service Started!
[INF] Session 27bf71c0-52fa-47ec-b561-dedec93d8757 opened.
[INF] Best Practice Site Id: 012345
[INF] Halo Connect Site Name: Halo Connect Clinic.
[INF] Halo GUID: 0000aaaa-a0aa-0aaa-00a0-0a0aa000a000.
[DBG] RemoteConfig.PollInterval 30000
[DBG] RemoteConfig.QueryResultPageSizeBytes 1024000.
[DBG] WebPubSub.BaseUrl wss://
[DBG] WebPubSub.GroupId 7da619f9-d9ee-4cdc-85f4-4f1cd360b788.
[DBG] WebSocket connected.

Key information includes:

  • The Halo Link version
  • Various config values
  • The Best Practice ID for the site
  • The Halo GUID used by integrations to query the site


If the Best Practice instance is using a developer license with Best Practice Site ID “0” then Halo Link will generate a Best Practice Site ID for the site. This is required for the GET /sites endpoint to be able to correctly retrieve the Halo GUID from the Best Practice ID.

Installer/MSI logs

Installer logs can be found under %USERPROFILE%\AppData\Local\Temp\ with the name(s) MSI*.LOG.

Windows Event Viewer logs

Event viewer > Windows Logs > Application > Filter Current Log


Logged: "Last 24 Hours" or "Last 7 Days" depending on investigation window

Event source: Halo Link Service


Event viewer > Windows Logs > System > Filter Current Log


Logged: "Last 24 Hours" or "Last 7 Days" depending on investigation window

Event source: Service Control Manager


Terminal Logs

Open terminal and run the following:

PS C:\Users\localadmin> cd 'C:\Program Files (x86)\Halo Connect\Halo Link\'
PS C:\Program Files (x86)\Halo Connect\Halo Link> .\HaloLinkService.exe