Skip to content

Latest commit

 

History

498 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Lumberjack - every layer of your app, ring by ring: errors, performance and logs on your own server

Latest release Tests Docker image Documentation License

Lumberjack

Lumberjack watches your apps from your own server, whatever they are built with. It collects errors, logs and performance data, runs health checks, sends alerts, shows status screens on a TV and lets AI agents work with your issues over MCP.

The overview of a project: requests, error rate, p95, failed jobs, open issues and health checks

What you can do with it

  • Know when production breaks. Exceptions, browser errors and error logs become issues, and an alert reaches you by email, Slack, Microsoft Teams, Discord, Telegram, ntfy, Pushover or a webhook. Source maps turn minified browser errors back into your own code.
  • Find out why a page is slow. Response times, Web Vitals, queries and N+1 hints per route, down to a single trace.
  • Check a release. See which deploy brought new errors or slowdowns.
  • Get a weekly summary. Each project's past week against the week before, by mail, chat or webhook.
  • Watch background work. See which jobs, scheduled tasks and commands failed or never ran, and which queues back up.
  • Check that your sites are up. Run HTTP, SSL, TCP, DNS and heartbeat checks, and track outages and uptime. Plan maintenance, or let your app report it, and the checks stay quiet while it lasts.
  • Search your logs, or watch them live.
  • Put a status screen on the wall. Design a dashboard and show it on any TV, with figures from GitHub, Vipps MobilePay, Umami or mosparo beside your own.
  • Watch an app in any language. Send traces and logs from an OpenTelemetry SDK or collector.
  • Let an AI agent read your errors. Agents can triage issues, write notes, open issues in your repository and draft pull requests.

An issue with its stack trace, occurrences and affected users

A status screen on a TV

Get started

Lumberjack runs as one Docker image, with Postgres and Redis beside it. On a server with Docker or Podman:

curl -fsSL https://exeque.github.io/lumberjack/install.sh | sh

Running Lumberjack with Docker has the whole setup. Your apps send data through a library, such as exeque/laravel-lumberjack for Laravel, or straight to the ingest API or over OpenTelemetry from any language or framework.

Guides

Reference