Better Stack Koa client

Start logging in 3 steps

1. Install

Install Logtail Koa NPM package:

npm install @logtail/koa

2. Setup

Set up Logtail client and attach it to 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 that all logs are sent to Logtail:

logtail.flush()

You should see your logs in Logtail → 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.