Website telemetry pixel

Add one script tag to capture client-side errors and failed requests from real visitors.

The telemetry pixel is a tiny <script> you add to any website. It runs in your visitors' browsers and reports real-user telemetry — the errors and failed requests people actually hit — back to your Telescope account as a connected source.

Add the script

Get an access key

Set up a telemetry source in your Telescope dashboard and copy the access key it gives you.

Drop the tag on your site

Add the script to your pages, using your key as data-key:

<script src="https://api.telescopealerts.com/pixel.js" data-key="YOUR_ACCESS_KEY" async></script>

Put it anywhere in your HTML — the pixel installs itself when it loads and starts reporting right away.

Confirm the exact script URL in your dashboard

The snippet above shows the shape of the tag and its attributes. Copy the exact src and pre-filled data-key from the source setup screen in your Telescope dashboard so you're using the current values.

What it captures

The pixel wraps the browser's error and network APIs and reports:

Uncaught errors and unhandled promise rejections
console.error and console.warn calls
Failed network requests — fetch and XHR calls that error or return a 4xx/5xx status
Failed resource loads — images, scripts, and stylesheets that don't load

Every handler is wrapped so the pixel never interferes with your page — if something goes wrong inside it, it fails silently rather than affecting your site.

Sending to a custom endpoint

By default the pixel sends to the Telescope API. If you route telemetry through your own host, set data-endpoint:

<script
  src="https://api.telescopealerts.com/pixel.js"
  data-key="YOUR_ACCESS_KEY"
  data-endpoint="https://telemetry.example.com"
  async
></script>

The pixel appends the telemetry path to whatever endpoint you provide.