Listener-based logging framework with asynchronous, thread-safe dispatch, multiple log levels, regex-based tag/message filtering, emoji console output, daily rotating file logs with cleanup, and custom listener support.
A powerful Kotlin Multiplatform logging library designed for cross-platform applications. DR-Logger provides a flexible, listener-based logging architecture with platform-specific implementations for Android, iOS, JVM, macOS, Linux, and Windows.
import pl.dronline.utils.log.DrLogger
import pl.dronline.utils.log.listener.EmojiConsoleLogListener
// Add a console listener
DrLogger.addListener(EmojiConsoleLogListener().apply {
enabled = true
})
// Create logger instance
val logger = DrLogger("MyApp")
// Log messages
logger.debug("Application started")
logger.info("User logged in")
logger.warn("Memory usage high")
logger.error("Failed to connect to server")
logger.fatal("Critical system failure")
logger.d("TAG", "Debug message")
logger.i("TAG", "Info message")
logger.w("TAG", "Warning message")
logger.e("TAG", "Error message")
try {
// Some code that might throw
} catch (e: Exception) {
logger.error(e, "Failed to process request")
}
Create custom log listeners by implementing ILogListener:
class CustomLogListener : ALogListener("CustomListener") {
override suspend fun onLogMessage(message: LogMessage) {
// Handle log message
println("[${message.level}] ${message.tag}: ")
}
}
DrLogger.addListener(CustomLogListener().apply { enabled = })
import pl.dronline.utils.log.listener.DailyFileLogListener
val fileListener = DailyFileLogListener().apply {
path = "/path/to/logs" // Directory is created automatically if it doesn't exist
namePrefix = "app-" // Log files: app-20250123.log
maxFileCount = 30 // Keep max 30 files
maxFileAgeDays = 90 // Delete files older than 90 days
maxFileSize = 10.MB // Optional: 10MB max per file (nginx-style rotation)
enabled = true
}
DrLogger.addListener(fileListener)
When maxFileSize is set, files rotate nginx-style within a day:
app-20250123.log - current file (always newest)app-20250123.1.log - previous fileapp-20250123.2.log - older fileAvailable size units: 10.bytes, 500.kB, 10.MB, 1.GB
// Filter by log level
listener.minLevel = DrLogLevel.WARN
// Filter by tag pattern
listener.tagFilter = Regex("^MyApp.*")
// Filter by message pattern
listener.messageFilter = Regex(".*error.*", RegexOption.IGNORE_CASE)
No additional setup required. Logcat integration works out of the box:
DrLogger.addListener(LogcatLogListener().apply { enabled = true })
For Log4j integration:
DrLogger.addListener(Log4jLogListener().apply { enabled = true })
Make sure Log4j is configured in your application.
Install required system dependencies:
sudo apt install libsystemd-dev gcc-multilib
Use SyslogLogListener for system logging:
DrLogger.addListener(SyslogLogListener(
ident = "myapp",
facility = SyslogFacility.USER
).apply { enabled = true })
View logs with: journalctl -t myapp or tail -f /var/log/syslog
No additional setup required. Use LogcatLogListener or SyslogLogListener to write to Windows Event Log.
Both delegate to EventLogLogListener internally.
View logs using Event Viewer (eventvwr.msc) under "Windows Logs" -> "Application":
// Using LogcatLogListener (default source: "DrLogger")
DrLogger.addListener(LogcatLogListener().apply { enabled = true })
// Or using SyslogLogListener with custom source name
DrLogger.addListener(SyslogLogListener(ident = "MyApp").apply { enabled = true })
Log levels are mapped to Event Log types:
No additional setup required. Native platform logging is automatically configured.
DR-Logger uses a central dispatch system (DrLoggerFactory) that routes log messages to registered listeners. Each
listener runs independently with its own coroutine scope, ensuring non-blocking operation.
┌──────────────┐
│ DrLogger │
└──────┬───────┘
│
v
┌──────────────────┐ ┌─────────────────┐
│ DrLoggerFactory │──────>│ ILogListener │
└──────────────────┘ └─────────────────┘
│ │
├────────────────────────────┼──────────────┐
v v v
┌─────────────┐ ┌────────────────┐ ┌──────────┐
│ Console │ │ File Logger │ │ Logcat │
└─────────────┘ └────────────────┘ └──────────┘
// Set minimum log level globally
DrLogger.minLevel = DrLogLevel.INFO
// Enable/disable specific listeners
listener.enabled = true
DR-Logger uses a 512-element buffer for log messages. Messages are processed asynchronously to avoid blocking the calling thread.
ANDROID_HOME environment variableThis project is licensed under the MIT License - see the LICENSE file for details.
Built with:
For questions, issues, or feature requests:
| Platform | Target | Min Version |
|---|
| Android | androidTarget | API 24 (Android 7.0) |
| iOS | iosArm64, iosX64, iosSimulatorArm64 | iOS 12+ |
| JVM | jvm | Java 8+ |
| macOS | macosArm64, macosX64 | macOS 10.13+ |
| Linux | linuxX64, linuxArm64 | glibc 2.27+ |
| Windows | mingwX64 | Windows 7+ |
Surfaced from shared tags and platforms — no rankings paid for.