See every request your API handles

• Live tail

  Requests on screen within a second, with live tiles, a route heatmap and new errors as they appear

• Alert rules

  On 5xx rate, p95 latency, counts or new and spiking errors, to email, Slack, Telegram or signed webhooks

• Email on 5xx

  Hear about server errors in real time, with throttling, digests, regression notices and one-click mute links

• Copy as cURL, replay

  Reproduce any request from your terminal, or replay it against a staging server you allowed

• Redaction, twice

  Passwords, tokens and card fields are masked in your app before sending, and again on the server

• Roles and body access

  Owners, admins, members and viewers, plus a separate permission to see request and response bodies

• Single sign-on

  Sign in with any OpenID Connect provider: Google, Microsoft Entra, Okta, Keycloak and others

• OpenTelemetry

  Point any OTLP/HTTP exporter at Trailscope and your spans become requests, for stacks without an SDK

npm install @trailscope/express

import express from 'express';
import { init, trailscope, trailscopeErrorHandler } from '@trailscope/express';

init({ service: 'orders-api' }); // endpoint and ingest key from the environment
const app = express();
app.use(trailscope());
// ... your routes
app.use(trailscopeErrorHandler());

npm install @trailscope/nestjs

import { Module } from '@nestjs/common';
import { TrailscopeModule } from '@trailscope/nestjs';

@Module({ imports: [TrailscopeModule.forRoot({ service: 'orders-api' })] })
export class AppModule {}

pip install trailscope

import trailscope
from fastapi import FastAPI
from trailscope.asgi import TrailscopeMiddleware

trailscope.init(service="orders-api")
app = FastAPI()
app.add_middleware(TrailscopeMiddleware)

pip install trailscope

MIDDLEWARE = ["trailscope.django.TrailscopeMiddleware", ...]
TRAILSCOPE = {"service": "orders-api"}

composer require trailscope/trailscope

TRAILSCOPE_ENDPOINT=https://trailscope.example.com
TRAILSCOPE_INGEST_KEY=trs_ingest_…
TRAILSCOPE_SERVICE=orders-api

<dependency>
  <groupId>pro.trailscope</groupId>
  <artifactId>trailscope-spring-boot-starter</artifactId>
  <version>0.1.0</version>
</dependency>

trailscope.service=orders-api

OTEL_EXPORTER_OTLP_ENDPOINT=https://trailscope.example.com/v1/otlp
OTEL_EXPORTER_OTLP_HEADERS=Authorization=Bearer%20trs_ingest_…

Then call setUser(id) or setCorrelation('order_id', id) anywhere in a request to make it part of a journey. All SDKs

• npm @trailscope/*
• PyPI trailscope
• Packagist trailscope/trailscope
• Maven Central pro.trailscope

Measured and reproducible: how we benchmarked

1. Start it

   Trailscope, ClickHouse and Postgres in one Compose file, with the published server image.

   git clone https://github.com/karaa1122/trailscope
   cd trailscope/deploy
   echo TRAILSCOPE_IMAGE=ghcr.io/karaa1122/trailscope:latest >> .env
   docker compose up -d

2. Create your project

   Open http://localhost:8080. The wizard creates your account and first project and shows its ingest key.

   docker compose exec trailscope \
     trailscope demo --url http://localhost:8080

   Optional: demo traffic with a scripted incident.

3. Add the SDK

   Install the package for your framework and set two environment variables. Production setup, TLS and backups: self-hosting guide.

   TRAILSCOPE_ENDPOINT=http://localhost:8080
   TRAILSCOPE_INGEST_KEY=trs_ingest_…