Understanding Monocle Application Health Status
Each Monocle application shows a health status dot indicating whether it's actively sending traffic. Learn what each color means, how to set each application's health threshold, how health alert emails work, and what to check if an application goes quiet.
Difficulty
Beginner
No prior Spur experience needed
Time estimate
3 minutes
Typical time to complete
Prerequisites
- A Monocle application set up in your Spur account
What you'll achieve
- Understand what each health status color means
- Set how long an application can go without traffic before it shows red
- Control who gets an email when an application goes quiet
- Know what to check when an application shows a red status
Steps
- 1
Check the status dot
Each application shows a colored status dot next to its name, in the application selector and in Quick Search:
- Gray: the application hasn't reported any data yet, so setup is still in progress
- Green: the application has seen traffic within its health threshold
- Red: the application has gone longer than its health threshold without traffic, which suggests Monocle may no longer be installed correctly. A warning also appears next to the application selector (see the next step).
The health threshold is 3 days unless your organization changes it. See Set the health threshold below.
- 2
Look for the traffic warning
When an application is red, a warning appears next to the application selector on every tab of that application, showing how long it's had no traffic, for example "No traffic in 4 days". Hover over the warning for the full message. On a small screen, only the warning icon shows.
- 3
Set the health threshold
Each application has its own threshold. Open the application's Settings page and, in the Notifications section, choose Alert after: 1, 2, 3, 4 or 7 days. The default is 3 days.
A shorter threshold suits an application with steady traffic, so a problem shows the next day. A longer one suits an application with quiet stretches, such as an internal tool used only on weekdays, so it doesn't turn red over a weekend.
Everyone in your organization can see the setting. Only organization admins can change it.
- 4
Get an email when an application goes quiet
Organization admins get an email when an application goes longer than its health threshold without traffic, the same moment its status dot turns red. Other members of your organization don't receive these emails.
The email is on for every application by default. There are two places to control it:
- For an application: open the application's Settings page and, in the Notifications section, switch Monocle health off or on. The Alert after setting beside it is the health threshold from the previous step. Everyone can see these settings; only organization admins can change them.
- For yourself: if you're an organization admin, open your Profile page and, in the Notifications section, switch Monocle health off to stop receiving these emails for every application. This doesn't change what other admins receive.
Turning the email off doesn't change the status dot: the application still turns red at its health threshold.
- 5
Investigate a quiet application
A red status usually means the Monocle snippet is no longer running on the site or app it was installed on, for example after a site redesign or a change to your content security policy. Re-check your installation using your integration's setup guide to confirm the snippet is still present and loading correctly.
If the application is simply quiet and Monocle is still installed, set a longer health threshold.
Related FAQs & guides
Why am I not seeing any data?
Check that your Monocle script is correctly installed, your publishable key is valid, and traffic is reaching your application.
Why did my Monocle assessment volume suddenly drop?
A sudden drop in assessment volume is usually caused by a change on your side — a recent deployment, a Content Security Policy (CSP) update, or a Cloudflare configuration change — rather than a Spur outage. To rule out a Spur-side issue, check https://status.spur.us. Then review your worker logs and recent configuration changes. If volume still looks incorrect after that, contact support@spur.us with the time the drop started and any recent changes you made.
Why is traffic not being blocked?
Monocle does not block traffic by default. Make sure you have implemented enforcement in your system, or configured a supported integration such as Cloudflare.
Why is my traffic marked as a VPN or proxy?
Monocle identifies traffic based on known infrastructure, behavior, and network signals. In some cases, shared networks or ISP routing may appear similar to anonymized traffic.
Why might the Monocle script fail to load?
This is usually caused by mcl.io being blocked by a firewall, DNS filter, or endpoint security tool. Confirm the domain is allowlisted, and test in an incognito window or from another network to isolate the cause.
Why did I get a Monocle health email?
A Monocle health email means one of your Monocle applications has gone longer than its health threshold without traffic, which usually means Monocle is no longer installed or running correctly on that site or app. Only organization admins get these emails. Check that the integration is still in place, or, if the application is simply quiet, set a longer threshold under Alert after on the application's Settings page. Admins can turn the email off for an application in the same Notifications section, or for themselves on their Profile page. See Understanding Monocle Application Health Status.