本番環境のモニタリング
Kotzillaプラットフォームは、本番環境(プロダクション)におけるKoinアプリを監視します。Kotzilla SDKがKoinコンテナに組み込まれ、実際のユーザーセッションで依存関係がどのように解決されたかを記録し、Kotzillaコンソールがこのデータをパフォーマンスの問題やクラッシュレポートに変換します。KotzillaはKoinを開発している企業です。このプラットフォームは独立したオプションのサービスであり、Koinはこれなしでも完全に動作します。
本番環境にデプロイする前段階では、Koin自体のツールが設定エラーの大半を検知します:コンパイル時安全性(Compile-Time Safety)、ロギング、およびモジュール検証。このページでは、リリース後に発生することについて説明します。すべてのツールの概要については、本番環境とツール(Production & Tooling)を参照してください。
検知対象
コンソールはセッションデータを「イシュー」としてグループ化します:
| イシュー | 意味 |
|---|---|
| Startup Performance | アプリ初期化時の遅延 |
| Main Thread Performance | 画面をフリーズさせるメインスレッド上での処理。メインスレッドで100ミリ秒以上かかった依存関係の解決がここにレポートされます |
| Background Performance | バックグラウンドスレッドの処理におけるボトルネック |
| Crashes | 実際のユーザーセッションから発生したクラッシュ |
コンソールには、パフォーマンスのボトルネック、クラッシュ、アーキテクチャ上の問題を調査するためのグラフィカルなビューが用意されています。同様のイシューは IDEプラグイン にも表示されます。
仕組み
SDKは起動時にKoinコンテナにフックします。それ以降、以下の2種類のデータを記録します。
- 構造(Structure): モジュール、定義、バインディングを含む依存関係グラフ。
- ランタイムの動作(Runtime behavior): 解決の所要時間、ライフサイクルイベント、クラッシュ。
クラスにトレース用のコードを追加する必要はありません。データはコンテナから直接取得されます。独自の関数もトレースしたい場合は、@Monitor を追加してください。
SDKがサポートするプラットフォーム: Android、およびiOS、JVMデスクトップ、JS、Wasmを含むKotlin Multiplatformターゲット。
セットアップの概要
詳細かつ最新の手順はKotzillaの公式ガイドに記載されています。基本的にはそちらをご利用ください。以下の概要はセットアップ全体の流れを示すためのものです。
- Kotzillaコンソール、IDEプラグイン、またはMCPサーバーからアカウントを作成し、アプリを登録します。アプリキーが含まれた
kotzilla.jsonファイルが取得できます。 - Kotzilla Gradleプラグイン(
io.kotzilla.kotzilla-plugin)とSDKの依存関係(io.kotzilla:kotzilla-sdk)を追加します。 kotzilla.jsonをアプリモジュール(Android)または共有モジュール(KMP)に配置します。startKoinブロックの最後でmonitoring()を呼び出します。
Androidでの例:
import io.kotzilla.generated.monitoring
class MainApplication : Application() {
override fun onCreate() {
super.onCreate()
startKoin {
androidContext(this@MainApplication)
modules(appModule)
monitoring()
}
}
}monitoring() は、kotzilla.json をもとにKotzilla Gradleプラグインによってビルド時に生成されます。これはComposable関数内からではなく、プラットフォームのエントリポイントごとに一度だけ呼び出してください。
プラットフォーム別ガイド:
NOTE
iOSでは、クラッシュのシンボル化(symbolication)にdSYMのアップロード手順が必要です。詳細はKotlin Multiplatformガイドで説明されています。
AIアシスタントとの統合
Kotzilla MCPサーバーは、AIコーディングアシスタント(Claude Code、Cursor、Windsurf、Android Studio、その他のMCPクライアント)をKoinの診断機能に接続します。Koinのエラーをアシスタントに貼り付けると、サーバーがそれを分類し、段階的な修正ワークフローを返します。以下を認識できます:
- Koin Compiler Pluginによる コンパイル時の診断情報(
KOIN-D001からKOIN-M001まで)。 NoBeanDefFoundException、InstanceCreationException、循環依存エラーなどの ランタイム例外。
エンドポイントは https://mcp.kotzilla.io/mcp(ストリーマブルHTTP)です。Claude Codeでの設定例:
claude mcp add kotzilla --transport http https://mcp.kotzilla.io/mcp初回利用時にKotzillaアカウントでのサインインが求められます。コンパイルエラーの修正はSDKがなくても機能します。ランタイム動作の分析にはSDKとセッションデータが必要です。
ビルド時にKoinの診断がレポートされると、Koin Compiler PluginはMCPサーバーを示すヒントを1つ出力します。これを無効にするには、koinCompiler { } ブロックで aiAssist = false を設定してください。
その他のクライアントについては、MCPサーバーガイド を参照してください。
データとプライバシー
SDKは技術的なセッションデータ(依存関係グラフおよび 仕組み に記載されているランタイムデータ)を送信します。MCPサーバーは、エラーテキストとアシスタントからの構造化クエリのみを送信します。ソースファイルがマシン外に送信されることはありません。
ポリシーの全文については、Kotzillaプライバシーポリシー を参照してください。
料金
Developerプランは無料で、利用期間の制限はなく、イベント数に一定の上限(クォータ)が設けられています。Enterpriseプランではチームコラボレーション機能が追加されます。最新のプランについては kotzilla.io をご覧ください。
サポートしていないこと
- ビルド時に設定を検証するわけではありません。 それは コンパイル時安全性 の役割です。
- テストの代替にはなりません。 リリース前の動作確認には テスト を使用してください。
- Koinによる依存関係の解決方法を変更するわけではありません。 SDKはコンテナを監視するだけであり、定義はそのまま維持されます。
- デフォルトでは独自コードをトレースしません。 @Monitor を追加しない限り、記録されるのはKoinによる解決のみです。
関連情報
- 本番環境とツール: 目的に応じたツールの使い分け。
- @Monitor: Kotzilla SDKで独自の関数をトレースする。
- IDEプラグイン: コードの隣で本番環境のイシューを確認する。
- トラブルシューティング: Koinのエラーの確認と修正。
- Kotzillaドキュメント: プラットフォームとSDKの完全なドキュメント。
