アプリ内バグ報告:振るだけで報告、ネットワークとログも添付
更新日
Midge の SDK を使うと、自社アプリの中に Report a bug(バグを報告)の流れを組み込めます。ユーザーはスマートフォンを振るか、あなたが用意したボタンをタップして、画面を録画し、何がおかしかったかを話します。レポートは、その間にアプリが何をしていたかと一緒に、あなたの Midge ワークスペースに届きます。HTTP リクエストとレスポンス、ログメッセージ、デバイス情報、そしてユーザー ID やプランなど、あなたが設定したコンテキストです。
「スマホで決済が壊れている」とだけ書かれたサポートチケットと、Pay のタップ、/api/orders からの 502、ユーザーのプランが 1 本のタイムラインに並んだチケット。その違いです。
3 つのプラットフォーム、1 つのワークスペース
| プラットフォーム | 追加方法 | ネットワークの記録 |
|---|---|---|
| ウェブサイトとウェブアプリ | <script> タグ 1 つ | fetch と XMLHttpRequest |
| iPhone と iPad(iOS 17 以降) | Swift パッケージ | URLSession |
| Android(API 26 以降) | Kotlin ライブラリ | OkHttp、HttpURLConnection、Volley、または Midge.network() |
どの SDK も録画リンクに送信するので、レポートは、チームが Chrome 拡張機能、Mac アプリ、iPhone アプリ、Android アプリで作ったレポートと同じワークスペースに届きます。
iOS でのセットアップ
import MidgeSDK
@main
struct ShopApp: App {
init() {
Midge.start(link: "rl_YOUR_TOKEN")
}
}
これで、スマートフォンを振ると報告画面が開くようになります。独自のボタンから開くには Midge.report() を呼び出してください。詳しいセットアップ:iOS SDK のドキュメント。
Android でのセットアップ
class ShopApplication : Application() {
override fun onCreate() {
super.onCreate()
Midge.start(this, link = "rl_YOUR_TOKEN")
}
}
val client = OkHttpClient.Builder()
.addInterceptor(Midge.okHttpInterceptor())
.build()
HttpURLConnection や Volley を使うコードでは、url.openConnection() の代わりに Midge.openConnection(url) を呼び出します。詳しいセットアップ:Android SDK のドキュメント。
ウェブでのセットアップ
<script src="https://midge.dev/sdk/v1.js" data-link="YOUR_LINK_TOKEN" async></script>
サイトの隅に Report a bug ボタンが表示されます。詳しいセットアップ:ウェブサイト SDK のドキュメント。
レポートに含まれる内容
- 画面録画: 対象はあなたのアプリだけです。ほかのアプリや通知は録画されません。
- ネットワークリクエスト: ヘッダー、最大 64 KB までのボディ、ステータス、タイミング付きです。
- ログ: iOS ではアプリの
Logger、os_log、NSLogのメッセージ、Android ではアプリ自身の logcat の行、ウェブではコンソールです。Midge.log()で独自の行も追加できます。 - デバイス: アプリ名、バージョンとビルド、端末のモデル、OS のバージョン、言語、タイムゾーンです。
- メタデータ:
Midge.metadata()で設定した値と、Midge.user()で設定した報告者の名前とメールアドレスです。
直近数分間のリクエストはメモリ上にだけ保持され、ユーザーが Send をタップしない限り何も送信されません。
端末上でマスキング
スマートフォンやブラウザからデータが送信される前に、Midge はパスワード、トークン、Cookie、Authorization ヘッダー、カード番号を取り除き、メールアドレスと電話番号をマスクし、ワークスペースで独自に指定した非表示フィールド名を適用します。モバイルでも Chrome 拡張機能と同じマスキングのコードが動くので、トークンはどこでも同じように検出されます。詳しくはマスキングをご覧ください。
送信できるのはあなたのアプリだけ
ウェブでは、SDK はワークスペースで確認済みのドメインからしか送信しません。モバイルでは、オーナーまたは管理者がアプリの bundle id や application id をワークスペースに登録します。それ以外のアプリでは、報告画面にその旨が表示され、何も送信されません。
自分で作らない理由
テキストボックスの内容をメールで送るだけの「フィードバックを送る」フォームなら簡単に作れます。難しいのは、その先で開発者が必要とするものすべてです。ユーザーが何をしたかの録画、失敗したリクエストとそのレスポンスボディ、その前後のログ、そしてそのどこにもお客さまのパスワードやカード番号が含まれていないという確信。これを 3 つのプラットフォーム向けに作り、マスキングし、保存するのは、それだけで 1 つのプロジェクトです。Midge なら、アプリごとに数行のコードで済み、レポートはチームがすでに働いている場所に届きます。
レポートから修正まで
各レポートは midge.dev で開き、動画とログが横に並び、再現手順付きの AI 要約が付きます。連携機能を使えば、ワンクリックで Jira、Linear、GitHub、Slack に引き渡せます。Claude Code や Cursor のようなコーディングエージェントは、Midge の MCP サーバー経由で同じレポートを読み取れます。
Midge は無料で、録画数は無制限、動画は最長 15 分、透かしも入りません。
よくある質問
- SDK はどのプラットフォームに対応していますか?
- ウェブサイトとウェブアプリには script タグで、iPhone と iPad のアプリ(iOS 17 以降)には Swift パッケージで、Android アプリ(Android 8.0、API 26 以降)には Kotlin ライブラリで対応しています。
- ユーザーはどうやって報告画面を開きますか?
- モバイルアプリでは、スマートフォンを振るか、Midge.report() を呼び出す独自の Report a bug ボタンから開きます。ウェブでは、スクリプトが追加する Report a bug ボタン、または独自のボタンから開きます。
- どのネットワークリクエストが記録されますか?
- iOS では URLSession のリクエストです。Android では、インターセプター経由の OkHttp(Retrofit、Coil、Ktor の OkHttp エンジンも含む)、HttpURLConnection、Volley、そして Midge.network() 経由でほかのあらゆるクライアントです。ウェブでは fetch と XMLHttpRequest です。
- 機密データが Midge に送られることはありますか?
- ありません。パスワード、トークン、Cookie、カード番号、ワークスペースで独自に指定した非表示フィールドは、送信前に端末上で、Chrome 拡張機能と同じコードによってマスキングされます。
- モバイル SDK はもう使えますか?
- ウェブサイト SDK はすべてのワークスペースで使えます。iOS と Android の SDK はアーリーアクセス中です。アプリ名を添えて [email protected] までメールでお問い合わせください。