Stream Log

? Stream Log is a lightweight and extensible logger library for Kotlin and Android.

Why Stream Log?

Stream Log has originated from stream-chat-android and it has been already verified as used by billions of global end-users across thousands of different apps. It’s simple and easy to use. You can also record and extract the runtime log messages into an external .txt file and utilize it to trace your log messages.

Stream Log

Stream Log is a lightweight logger and a pure Kotlin module to utilize this library on your Kotlin projects.

Add the dependency below into your module‘s build.gradle file:

dependencies {
    implementation("io.getstream:stream-log:$version")
}

StreamLog

StreamLog is a primary log manager, which allows you to install your loggers and print log messages. First, you need to install a StreamLogger on StreamLog. In the Kotlin project, you can install KotlinStreamLogger by default, which is a simple logger for Kotlin as seen below:

// install `KotlinStreamLogger`. You only need to do this once.
StreamLog.install(KotlinStreamLogger())

// change the log validator as your taste. 
StreamLog.setValidator { priority, _ ->
  priority.level >= Priority.DEBUG.level
}

Now, you can print log messages simply like the below:

streamLog { "This is a log messages" }
streamLog(priority = Priority.INFO, tag = "Tag") { "This is a log messages" }
StreamLog.d(tag = "Tag") { "This is a log message" }

Then you will get the log messages below:

+  D  2022-12-02 15:42:49'044 (main:2) [D/MessageRepository]: This is a log message!
+  I  2022-12-02 15:42:49'044 (main:2) [I/Tag]: This is a log message!
+  D  2022-12-02 15:42:49'044 (main:2) [D/Tag]: This is a log message!

Also, you can get the logger, which is installed on StreamLog like the below:

val logger = StreamLog.getLogger("Tag")
logger.d { "This is a log message" }

// Getting a tagged logger lazily.
val logger by taggedLogger()
val logger by taggedLogger(tag = "Tag")

Note: If you don’t specify the tag parameter, the tag value will be a class name that is logging currently.

StreamLogger

StreamLogger is a low-level logger interface that can be installed/uninstalled on StreamLog. You can create your own logger by extending the StreamLogger interface like the below:

public class MyStreamLogger() : StreamLogger {

    override fun log(priority: Priority, tag: String, message: String, throwable: Throwable?) {
        
        // do something here
        ..

        println(message)
    }
}

You can also extend the KotlinStreamLogger and customize the behaviors like the below:

object ErrorStreamLogger : KotlinStreamLogger() {

    override fun log(priority: Priority, tag: String, message: String, throwable: Throwable?) {
        when (priority) {
            ERROR, ASSERT -> super.log(priority, tag, message, throwable)
            else -> { /* NO-OP */ }
        }
    }
}

CompositeStreamLogger

You can separate roles and behaviors for each different logger and composite the loggers into a single logger with CompositeStreamLogger.

val fileLogger = FileStreamLogger(fileLoggerConfig)
val androidLogger = AndroidStreamLogger()
val compositeLogger = CompositeStreamLogger(androidLogger, fileLogger)
StreamLog.install(compositeLogger)

Validator

The validator decides whether the log messages should be printed or not. You can set a validator to set the behaviors of your logger.

// Show log messages if the log priority is DEBUG or more than DEBUG.
StreamLog.setValidator { priority, tag ->
    priority.level >= Priority.DEBUG.level
}

// Show log messages if the tag contains a "main" string.
StreamLog.setValidator { priority, tag ->
    tag.contains("main")
}

Stream Log File

Stream Log File is an extension library for persisting the log messages into an external .txt file.

Add the dependency below into your module‘s build.gradle file:

dependencies {
    implementation("io.getstream:stream-log:$version")
    debugImplementation("io.getstream:stream-log-file:$version")
}

FileStreamLogger

You can persist the log messages that are triggered on runtime with FileStreamLogger. To persist your log messages into a file, you should use FileStreamLogger with CompositeStreamLogger like the example below:

val fileLoggerConfig = FileStreamLogger.Config(
    filesDir = fileDirectory, // an internal file directory
    externalFilesDir = null, // an external file directory. This is an optional.
    app = FileStreamLogger.Config.App( // application information.
        versionCode = 1,
        versionName = "1.0.0"
    ),
    device = FileStreamLogger.Config.Device( // device information
        model = "%s %s".format(Build.MANUFACTURER, Build.DEVICE),
        androidApiLevel = Build.VERSION.SDK_INT
    )
)
val fileLogger = FileStreamLogger(fileLoggerConfig)
val kotlinLogger = KotlinStreamLogger()
val compositeLogger = CompositeStreamLogger(kotlinLogger, fileLogger)

StreamLog.install(compositeLogger)

Then you will get the result .txt file below:

======================================================================
Logs date time: 2022-12-02 21:08:35'288
Version code: 1
Version name: 1.0.0
API level: 10
Device: Stream's Mac
======================================================================
2022-11-30 13:02:29'918 D/              This is a log message
2022-11-30 13:04:08'577 D/              ChatViewModel initialized
2022-11-30 13:13:04'640 D/              ChatController initialized

Stream Log Android

Stream Log Android is a simple Android logger on top of the Stream Log.

Add the dependency below into your module‘s build.gradle file:

dependencies {
    implementation("io.getstream:stream-log-android:$version")
}

AndroidStreamLogger

First, you need to install a logger for Android with AndroidStreamLogger like the below:

class App : Application() {

    override fun onCreate() {
        super.onCreate()

         // change the log validator as your taste.
        StreamLog.setValidator { priority, _ -> priority.level >= Priority.DEBUG.level }

        // install AndroidStreamLogger.
        AndroidStreamLogger.installOnDebuggableApp(this)
    }
}

Note: We’d recommend you install the logger only once in your application class.

Now, you can print log messages simply like the below:

streamLog { "This is a log messages" }
streamLog(priority = Priority.INFO, tag = "Tag") { "This is a log messages" }
StreamLog.d(tag = "Tag") { "This is a log message" }

Then you will get the log messages below:

+  D  2022-12-02 15:42:49'044 (main:2) [D/MessageRepository]: This is a log message!
+  I  2022-12-02 15:42:49'044 (main:2) [I/Tag]: This is a log message!
+  D  2022-12-02 15:42:49'044 (main:2) [D/Tag]: This is a log message!

You also can get the logger, which is installed on StreamLog like the below:

val logger = StreamLog.getLogger("Tag")
logger.d { "This is a log message" }

// Getting a tagged logger lazily.
val logger by taggedLogger()
val logger by taggedLogger(tag = "Tag")

Note: If you don’t specify the tag parameter, the tag value will be a class name that is logging currently. In Jetpack Compose, the tag will be the scope’s name of Composable functions.

Stream Log Android File

Stream Log Android File is an extension library for persisting your log messages into external .txt files. So you can record the runtime log messages into a .txt file, and it will help you to trace the log messages in many complex scenarios.

Add the dependency below into your module‘s build.gradle file:

dependencies {
    implementation("io.getstream:stream-log-android:$version")
    debugImplementation("io.getstream:stream-log-android-file:$version")
}

AndroidStreamLogger

First, you need to install a logger for Android with AndroidStreamLogger like the below:

class App : Application() {

    override fun onCreate() {
        super.onCreate()

        AndroidStreamLogger.installOnDebuggableApp(this)
    }
}

Note: We’d recommend you install the logger only once in your application class.

Now, you can print log messages simply like the below:

streamLog { "This is a log messages" }
streamLog(priority = Priority.INFO, tag = "Tag") { "This is a log messages" }
StreamLog.d(tag = "Tag") { "This is a log message" }

Record Runtime Log Messages Into an External File

You don’t need to do additional setup for this, because the stream-log-android-file dependency will execute all processes automatically. So let’s extract the log messages into an external file following the command lines below on your terminal:

Build and run your project on your emulator or connect to your real device over Wi-Fi following the Connect to a device over Wi-Fi guidelines.
Enter in terminal: adb shell am start-foreground-service -a io.getstream.log.android.CLEAR
You should see the toast message Logs are cleared!.
Explore your app to record specific log messages.
Enter in terminal: adb shell am start-foreground-service -a io.getstream.log.android.SHARE
You should see a file-sharing dialog chooser in your device.
Share the log file via other applications, such as Google Cloud.
Exit recording log messages by enter in terminal: adb shell am stopservice -a io.getstream.log.android.SHARE

Then you will get the result .txt file below:

======================================================================
Logs date time: 2022-12-02 21:08:35'288
Version code: 1
Version name: 1.0.1
Android API level: 31
Device: samsung beyond1
======================================================================
2022-11-30 13:02:29'918 D/              main:2 [Main]: onCreate MainActivity
2022-11-30 13:13:06'656 D/              main:2 [Main]: Button clicked
2022-11-30 13:13:07'225 D/              main:2 [Main]: Button clicked
2022-11-30 13:13:07'439 D/              main:2 [Main]: Button clicked
2022-11-30 13:14:23'316 D/              main:2 [Main]: onCreate MainActivity
2022-11-30 13:14:24'296 D/              main:2 [Main]: Button clicked
2022-11-30 13:14:24'723 D/              main:2 [Main]: Button clicked
2022-11-30 16:36:39'102 D/              main:2 [MainActivity]: onCreate MainActivity
2022-11-30 16:42:48'987 D/              main:2 [BoxScopeInstance]: Button Clicked!
2022-11-30 16:42:49'873 D/              main:2 [BoxScopeInstance]: Button Clicked!

Stream Log BOM

The Stream Log Bill of Materials (BOM) lets you manage all of your Stream Log library versions by specifying only the BOM’s version.

dependencies {
    implementation("io.getstream:stream-log-bom:$version")

    implementation("io.getstream:stream-log")
    implementation("io.getstream:stream-log-file")
    implementation("io.getstream:stream-log-android")
    implementation("io.getstream:stream-log-android-file")
}

Find this library useful? ❤️

Support it by joining stargazers for this repository. ⭐ Also, follow Stream on Twitter for our next creations!

License

Copyright 2022 Stream.IO, Inc. All Rights Reserved.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

GitHub

View Github

A lightweight and extensible logger library for Kotlin and Android

Stream Log

Why Stream Log?

Stream Log

StreamLog

StreamLogger

CompositeStreamLogger

Validator

Stream Log File

FileStreamLogger

Stream Log Android

AndroidStreamLogger

Stream Log Android File

AndroidStreamLogger

Record Runtime Log Messages Into an External File

Stream Log BOM

Find this library useful? ❤️

License

GitHub

Simple project using android jetpack compose to build UI for beginer

MicoPass API Client for Kotlin

Stream Log

Why Stream Log?

Stream Log

StreamLog

StreamLogger

CompositeStreamLogger

Validator

Stream Log File

FileStreamLogger

Stream Log Android

AndroidStreamLogger

Stream Log Android File

AndroidStreamLogger

Record Runtime Log Messages Into an External File

Stream Log BOM

Find this library useful? ❤️

License

GitHub

Simple project using android jetpack compose to build UI for beginer

MicoPass API Client for Kotlin

You might also like...

Subscribe to Android Example 365