No description
Find a file
2026-03-15 00:15:45 +01:00
.forgejo/workflows Update .forgejo/workflows/publish.yml 2026-03-13 22:37:34 +01:00
gradle Add gradle wrapper jar 2026-03-13 22:40:26 +01:00
src Add Ktor integration tests for LogRouting and LogBrowser plugin 2026-03-13 10:52:05 +01:00
.gitignore Initial commit: browserlog Ktor plugin for log viewing via SSE 2026-03-12 05:03:57 +01:00
.gitlab-ci.yml Add GitLab CI configuration 2026-03-14 08:51:06 +01:00
AGENTS.md Update AGENTS.md with test commands and coverage info 2026-03-13 11:13:04 +01:00
build.gradle.kts publishing on gitlab via CI 2026-03-14 09:46:56 +01:00
gradlew Initial commit: browserlog Ktor plugin for log viewing via SSE 2026-03-12 05:03:57 +01:00
gradlew.bat Initial commit: browserlog Ktor plugin for log viewing via SSE 2026-03-12 05:03:57 +01:00
opencode.json updated versions 2026-03-12 16:02:02 +01:00
README.md Add README.md with usage documentation 2026-03-15 00:15:45 +01:00
settings.gradle.kts Add Axion release plugin for semantic versioning 2026-03-12 15:26:11 +01:00

browserlog

A Ktor plugin for browsing application logs in a web browser via Server-Sent Events (SSE).

Features

  • Real-time log streaming via SSE
  • Dark-themed web UI
  • Automatic log level coloring (INFO, WARN, ERROR)
  • Configurable endpoint and title

Add Dependency

Gradle (Kotlin DSL):

implementation("com.gitlab.ronsmits:browserlog:0.1.0")

Usage

1. Add Logback Appender

In your logback.xml or logback-spring.xml:

<appender name="HTML_STREAM" class="org.ronsmits.logbrowser.LogbackAppender" />
<root level="INFO">
    <appender-ref ref="HTML_STREAM"/>
</root>

2. Install Plugin

install(LogBrowser)

Or with custom configuration:

install(LogBrowser) {
    endpoint = "/my-logs"
    title = "My Application Logs"
}

Configuration

Property Type Default Description
endpoint String /logs URL endpoint for the log browser
title String Application Logs Page title

Endpoints

  • GET /logs - HTML UI
  • GET /logs/stream - SSE stream
  • GET /logs/ping - Test endpoint (logs a message)

License

MIT