LogNorth Documentation

LogNorth

Logs + error tracking. Self-hosted.

Quick Start

1. Install

npm install @karloscodes/lognorth-sdk

2. Configure

import LogNorth from '@karloscodes/lognorth-sdk'

LogNorth.config('https://logs.yoursite.com', 'your-api-key')

3. Log

LogNorth.log('User signed up', { user_id: 123 })

LogNorth.error('Payment failed', err, { user_id: 123 })

4. Add middleware (optional)

import { middleware } from '@karloscodes/lognorth-sdk/express'

app.use(middleware())

How It Works

Method	Behavior
LogNorth.log()	Batched (10 events or 5s)
LogNorth.error()	Sent immediately

Integrations

• Bun / Node.js
• Go

Under the Hood

Just HTTP POST. No vendor lock-in.

POST /api/v1/events/batch
Authorization: Bearer YOUR_API_KEY

{"events": [{"message": "...", "context": {...}}]}