Skip to main content
A call your own server makes is not a visitor or an agent. A page rendered on your server that reads your API through the edge records a step for every read, all from a few addresses at a steady rate. Those steps crowd out the journeys you want to see. So leave them out. Have your servers send a secret on their own calls, then tell Agentrail to skip any request that carries it. Check the secret is set before you start: unset, a request with no such header would match, and nothing would be recorded.

On the edge

Add ignoreRequest to the edge’s options:
A request it matches goes to your site untouched, and nothing is recorded. If your check throws, onError is told and the request is recorded like any other, so a broken check never takes down a visitor’s request.

In the Node SDK

Add ignoreIncomingRequest to the options of init:

In the Go SDK

Set IgnoreIncomingRequest in the options of agentrail.New:

In the Python SDK

Pass ignore_incoming_request in the options of init:
If your check raises, on_error is told and the request is recorded like any other.

Why a secret

Check something only your servers can send. Any caller can send any user agent, and an address is shared by everything behind it. If you skip by either, a caller that matches is never recorded, and you never find out. A shared secret is the one thing a caller cannot claim. Use a long random value, keep it in your platform’s secrets, and compare it in constant time where your platform offers that.