Understanding Monocle Application Health Status
Each Monocle application shows a health status badge indicating whether it's actively sending traffic. Learn what each color means and what to check if an application goes quiet.
Difficulty
Beginner
No prior Spur experience needed
Time estimate
2 minutes
Typical time to complete
Prerequisites
- A Monocle application set up in your Spur account
What you'll achieve
- Understand what each health status badge means
- Know what to check when an application shows an amber or red status
Steps
- 1
Check the status badge
Each application in your Monocle dashboard shows a colored status badge next to its name:
- Gray — the application has never reported data yet; setup is still in progress
- Green — traffic was observed within the last 24 hours (healthy)
- Amber — no traffic for between 24 and 72 hours; often a temporary quiet stretch rather than a real problem
- Red — no traffic for more than 72 hours (3 days), suggesting Monocle may no longer be installed correctly
- 2
Look for the traffic warning banner
When an application is in amber or red status, a warning banner appears next to the application selector, showing how long it's been quiet. Hover over the banner for the full message.
- 3
Investigate a quiet application
An amber or 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.
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. Check your worker logs and recent configuration changes first. 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.
What is the difference between using Monocle to monitor vs. enforce traffic decisions?
Monitor is passive: Monocle provides visibility into how users connect to your application without impacting users or taking any blocking action. Enforce applies actions such as blocking or allowing traffic based on Monocle's assessments. Most users start with a monitoring phase before configuring and enabling enforcement.