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.
Can we decrypt Monocle assessments ourselves instead of calling an API?
Yes — this is already supported at no extra cost. Every Monocle application has both a Secret Key (for the hosted Decryption API) and a Private Key (for manual backend decryption) available in the Monocle Dashboard. Backend decryption lets your own server decrypt the Monocle Assessment locally using the Private Key, without making a call to Spur's Decryption API.
Related guides & explainers
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.
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.