Node.js · API monitoring & observability

Koa API monitoring & analytics

Koa's minimal middleware stack means observability is on you. Beacon's Koa middleware wraps await next() and records on completion — register it before your @koa/router so it sees the matched route template and reports low-cardinality endpoints instead of raw paths.

100,000 requests per month on the free tier — no credit card to start.

Add Beacon to Koa in two steps

Drop-in middleware. The SDK defaults to Beacon's hosted ingest endpoint, so you only need a project ingest key — set it as BEACON_INGEST_KEY in your environment.

1. Install
npm install beaconhq
2. Add the middleware
import Koa from 'koa';
import Router from '@koa/router';
import { BeaconClient, beaconKoa } from 'beaconhq';

const app = new Koa();
const beacon = new BeaconClient({ apiKey: process.env.BEACON_INGEST_KEY });

app.use(beaconKoa(beacon)); // before the router

const router = new Router();
router.get('/users/:id', (ctx) => { ctx.body = ctx.params.id; });
app.use(router.routes());

app.listen(3000);

Create a project in the dashboard to get your ingest key, then deploy. Traffic, latency, errors, and endpoints populate in real time. Full setup in the docs.

Everything you need to keep your Koa API healthy

One place for traffic, latency, errors, uptime, and scheduled-job health — built for teams who need to know what their API is doing right now.

Traffic & latency percentiles

Per-request volume with p50/p95/p99 latency, so you see real tail latency — not just averages.

Error rates & error explorer

Track 4xx/5xx over time and drill into the exact failing requests, status codes, and endpoints behind an incident.

Endpoint & consumer breakdowns

See which endpoints and which API consumers drive your traffic, errors, and slowest responses — ranked and filterable.

Request-log explorer

A searchable log of individual requests — method, path, status, latency, consumer — the fast path from a metric spike to the requests behind it.

Uptime, cron & heartbeat monitoring

Synthetic uptime checks plus dead-man's-switch heartbeat monitoring for cron jobs and background workers.

Status pages & alerts

Public status pages and multi-channel alerts — email, Slack, PagerDuty, Discord, Teams, and signed webhooks — when something breaks.

Start monitoring your Koa API today

100,000 requests per month on the free tier — no credit card to start. Connect your first service in minutes.