Koa version 2.6.2 or higher is required.
Explore documentation
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");
// 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.