Skip to main content

Kotzilla Console

The Kotzilla Console is a web-based environment that helps you analyze and resolve issues in your Kotlin and Kotlin Multiplatform (KMP) applications. It provides a comprehensive suite of tools for detecting, investigating, and resolving performance and stability issues across your apps.

Automatic Issue Detection

The Kotzilla Console automatically detects and surfaces critical issues in your app without requiring any additional instrumentation of your code. It uses the Kotzilla SDK to identify the following types of issues:

  • Startup performance issues: Delays in app initialization, preventing the first usable screen from appearing quickly.
  • Background performance issues: Slow or resource-heavy background tasks impacting app responsiveness.
  • Main thread performance issues: Tasks running on the main thread for over 100ms, potentially leading to freezes or ANRs.
  • Dependency performance issues: Inefficient resolution of dependencies slowing down app responsiveness.
  • Dependency complexity issues: Complex dependency graphs with more than five child dependencies, increasing maintenance and performance risks.
  • Child dependency performance issues: Dependencies taking over 5ms to resolve, causing cascading performance slowdowns.

Investigating issues and root cause analysis

The Kotzilla Console is designed for in-depth issue investigation and root cause analysis. It offers several views that provide rich contextual information to help you quickly diagnose and fix problems.

Dashboard View

The Dashboard is the first view you’ll see upon accessing the Kotzilla Console for a specific app. It gives you an overview of your app's health, highlighting any critical issues and user sessions. From here, you can easily see:

  • The overall health of your app or SDK library
  • A list of detected issues across versions and number of impacted user sessions
  • A list of user sessions recorded for your app or SDK library

The Dashboard ensures that you can quickly identify what's most critical to address across your app versions.

Issues View

The Issues View provides a comprehensive list of detected issues, including crashes, performance problems, and custom issues tracked via the Kotzilla SDK API. For each detected issue, the following details are available:

  • Description of the issue: A concise explanation of the issue type and its impact
  • Impacted user sessions: Which sessions were affected by this issue
  • Affected app versions: Which versions of the app are impacted
  • Issue status: Whether the issue is open, acknowledged, or closed

You can click on any issue to view detailed information such as stack traces for crashes, or explanations on the cause of the issue for performance, memory and app complexity problems. The issue details view also shows impacted user sessions, allowing you to continue the investigation down to specific user sessions

Timeline View

The Timeline View is designed to help you investigate issues and understand the flow of events that led to them in a specific user session. It provides a detailed, visual representation of app component lifecycles, thread activity, and events in each user session. The Timeline View enables you to:

  • Graphically identify issues: Issues are marked in the timeline with flags, making it easy to pinpoint the exact component or action causing the problem.
  • Navigate from the Issues View: When you access an issue from the Issues View, you are taken directly to the relevant event or component in the Timeline View. From there, you can expand the tree to explore related events or dependencies and continue your investigation.

  • Filter and search events: The Timeline View supports full-text filtering by category, content, and thread, allowing you to quickly find specific events or issues within the timeline.

Koin IDE Plugin integration

If you want to view and address issues directly within your development environment, the Koin IDE Plugin integrates with the Kotzilla Console. The plugin includes a Issues view that lists detected issues and impacted user sessions within your IDE. You can use the plugin to view a list of detected issues and then explore the details in the Kotzilla Console for further investigation.