How do I integrate Monocle?
The most common way is by adding a JavaScript snippet to your application. You can also integrate Monocle using backend or edge-based approaches depending on your setup. See https://docs.spur.us/monocle/integrations for details.
Similar questions
Do I need a backend to use Monocle?
No. You can use Monocle to gain visibility into traffic intelligence via the Monocle UI without acting on it. With a supported integration like Cloudflare, traffic can be enforced directly from the UI based on policy configuration. A backend is only required if you want to decrypt assessments or apply custom enforcement logic.
How long does it take to see data?
Typically within minutes of integrating Monocle. In some cases, it may take up to an hour for data to appear in the dashboard.
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.
Where does enforcement actually happen?
In most setups, enforcement happens in your own infrastructure, such as backend logic, API gateways, or middleware. For Cloudflare integrations, enforcement can happen at the edge and is directly configurable via the Monocle UI.
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.
Related guides & explainers
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.
Expanding IP and Service Rows in the Explorer
Click any IP or service row in the Monocle Explorer's breakdown tables to expand an inline detail panel, without leaving the table.
Fastly No-Code Integration
Connect Monocle to your Fastly service without writing any code. Monocle deploys and manages a Compute service that enforces your policy at the edge.
Why the Organization Field Isn't Available the Same Way Across Spur's Data Feeds
The Context API's per-IP organization field isn't guaranteed in every data feed. Each feed has a different schema and covers a different slice of IP space, so field availability varies by feed.