Koa Error and Performance Monitoring

Koa Actionable insights to resolve Koa performance bottlenecks and errors. Improve your Koa monitoring workflow with a full view of releases so you can mark errors as resolved and prioritize live issues.

Try Sentry For FreeRequest a Demo

Getting Started is Simple

Add @sentry/node as a dependency:

npm install --save @sentry/node

Initialize the Sentry SDK and install the on error hook:

import Koa from "koa";
import * as Sentry from "@sentry/node";

// or using CommonJS
// const Koa = require('koa');
// const Sentry = require('@sentry/node');

const app = new Koa();

Sentry.init({ dsn: "https://<key>@sentry.io/<project>" });

app.on("error", (err, ctx) => {
  Sentry.withScope(function(scope) {
    scope.addEventProcessor(function(event) {
      return Sentry.Handlers.parseRequest(event, ctx.request);


That’s it. Be sure to check out our documentation to ensure you have the latest instructions.

See all platforms

Koa Performance Monitoring

Quickly identify Koa performance issues and view full end-to-end distributed trace to see the exact, poor-performing API call and surface any related errors.

Koa Error Monitoring with Complete Stack Traces

See the Koa source code at each frame instead of settings for just line and column numbers. Get proper asynchronous context tracking -— like thread-local store — in a way that fits Node’s concurrency model.

Fill In The Blanks About Koa Errors

See what the app was doing when the Koa error occurred: HTTP requests, database queries, console loft statements, etc.

“Sentry’s high-quality tooling helps Disney+ maintain high-quality service to its tens of millions of global subscribers.”

Andrew Hay
Director, Disney+

Debugging Any Koa Exception

Aggregate errors by factors like request details, user ID, and event level to see what’s new, a priority, or a trend.

Assign custom key-value tags to reproduce the error environment specific to your application, business, and users.

Find answers to key questions: Has an error with the same stack occurred before? In which app release did the Koa bug occur?

It’s why companies that don’t have a complete view of their infrastructure are being punished:

The average cost of network downtime is around $5,600 per minute — or $300,000 per hour.

1 out of 5 online shoppers will abandon their cart because the transaction process was too slow.

On average, a two-second slowdown in page load decreases revenues by 4.3 percent.


Traditional logging provides you with a trail of events. Some of those events are errors, but many times they’re simply informational. Sentry is fundamentally different because we focus on exceptions, or in other words, we capture application crashes. We discuss in more detail here and on our blog.

Sentry supports every major language, framework, and library. You can browse each of them here.

You can get started for free. Pricing depends on the number of monthly events, transactions, and attachments that you send Sentry. For more details, visit our pricing page.

Sentry doesn’t impact a web site’s performance.

If you look at the configuration options for when you initialize Sentry in your code, you’ll see there’s nothing regarding minimizing its impact on your app’s performance. This is because our team of SDK engineers already developed Sentry with this in mind.

Sentry is a listener/handler for errors that asynchronously sends out the error/event to Sentry.io. This is non-blocking. The error/event only goes out if this is an error.

Global handlers have almost no impact as well, as they are native APIs provided by the browsers.

Supporting Resources

Performance Monitoring with Node.js


A better experience for your users. An easier life for your developers.

© 2021 • Sentry is a registered Trademark
of Functional Software, Inc.