Better Stack Koa client

Start logging in 3 steps

1. Install

Install the @logtail/koa npm package:

npm install @logtail/koa

2. Set up

Set up the Better Stack client and attach it to your Koa instance:

const Koa = require("koa");
const { Logtail } = require("@logtail/koa");

// Create new Koa instance
const koa = new Koa();

// Create new Logtail client
const logtail = new Logtail("$SOURCE_TOKEN", {
  endpoint: 'https://$INGESTING_HOST',
});

// Attach Koa to enable HTTP request logging
logtail.attach(koa);

3. Start logging

All HTTP requests handled by Koa will be logged and sent to Better Stack.

Ensure all logs are flushed to Better Stack:

logtail.flush()

You should see your logs in Better Stack → Live tail.

Need help?

Please let us know at hello@betterstack.com.
We're happy to help! 🙏

Additional information

How the middleware works

Successful requests

Successful requests end with a 2xx or 3xx status codes and do not throw any errors. They are logged to Logtail using Info log level.

4xx status codes

Requests with 4xx status codes are considered warnings. Such requests are logged to Logtail with Warn log level.

5xx status codes

Requests with 5xx status codes are considered errors. Such requests are logged to Logtail with Error log level.

Uncaught errors

Unhandled errors are caught by Logtail middleware. The errors are logged to Logtail with Error log level.

Additional logging

With Logtail Koa client you can use debug(), info(), warn(), and error() methods just like with Logtail JavaScript client.