開発者向けのバグ報告:自分で集めるはずだった証拠が、最初から揃っている
更新日
開発者にとって良いバグ報告とは、自分で集めるはずだったものが入っている報告です。スタックトレース付きのコンソールエラー、ボディ付きの失敗したリクエスト、そこに至るまでの手順、そして発生したブラウザ。Midge はそれらすべてを Chrome のタブから自動で記録し、動画と 1 本のタイムラインにそろえ、アップロード前に機密情報をマスキングします。だからレポートを、チケットにも、プルリクエストにも、AI チャットにも安心して貼り付けられます。
すべての録画に、コンソールログ、ネットワークリクエスト、ユーザー操作、デバイス情報が含まれます。つまり「コンソールを送ってもらえますか?」というメッセージが減り、最初に読んだ時点で直せるバグが増えます。
レポートに入っているもの
1 本のタイムライン
動画の横に、コンソールメッセージ、ネットワークリクエスト、ユーザー操作のパネルが、すべて時系列で並びます。Save のクリックを見れば、その直後の PATCH /api/projects/88 がすぐそこにあり、レスポンスが届いた数ミリ秒後に Uncaught TypeError が出ています。3 つの添付ファイルから順番を組み立て直す必要はありません。
スタックトレース付きのコンソール
debug から error までのすべてのレベルに加え、キャッチされなかった例外と処理されなかった Promise の reject を、スタック付きで記録します。Midge はページの読み込みと同時に記録を始めるので、起動時のエラーも含まれます。さらに直近のログをバッファに保持し続けるため、テスターが録画ボタンを押す前のエラーも残っています。詳しくはコンソールログのページをご覧ください。
ネットワークの詳細
fetch と XHR のリクエストには、ヘッダー、リクエストとレスポンスのボディ、ステータスコード、タイミングが付きます。WebSocket のメッセージは双方向で記録されます。そのほかのリソースは、ステータス、サイズ、タイミングが表示されます。GraphQL では各リクエストにオペレーション名が表示され、errors 配列を含む 200 レスポンスには印が付きます。ステータスで絞り込むだけでは見逃してしまうからです。詳しくはネットワークログのページをご覧ください。
デバイス情報
ブラウザとそのバージョン、OS、ウインドウサイズ、言語、タイムゾーン、URL を記録します。同じ環境を再現するにも、バグがドイツ語ロケールでしか起きないことに気づくにも十分な情報です。
cURL としてコピー
どのリクエストも cURL コマンドとしてコピーし、ターミナルから実行できます。
curl 'https://staging.acme.dev/api/projects/88' \
-X PATCH \
-H 'Content-Type: application/json' \
-H 'Authorization: [REDACTED]' \
--data-raw '{"name":"Q4 roadmap","archived":null}'
Authorization ヘッダーが伏せられているのは意図的です。自分のテストユーザーのトークンを入れれば、誰かに稼働中のセッションを共有してもらわなくても、まったく同じリクエストを再現できます。自分の環境のトークンを調べたい場合は、無料の JWT デコーダーを使えば、どこにも送信せずにクレームと有効期限を確認できます。
マスキング済みの HAR をダウンロード
パフォーマンスの調査や API ベンダーのサポートへの問い合わせなどで、ネットワークログ全体が必要なときは、HAR ファイルとしてダウンロードできます。ファイルに含まれるのはマスキング済みのデータです。無料の HAR ビューアや、HAR を読める任意のツールで開けます。誰かが DevTools から直接書き出した HAR を扱う場合は、転送する前に「HAR ファイルから機密データを削除する方法」をお読みください。
安心して貼り付けられるマスキング
バグ報告は、チケット、Slack のスレッド、プルリクエストの説明、コーディングアシスタントとのチャットなど、あらゆる場所に貼られます。パスワード、カード番号、トークン、Cookie は、デバイスから送信される前にブラウザ内で伏せられます。対象には次のものが含まれます。
Authorization、Cookie、Set-Cookieヘッダーと、名前に token、secret、session、auth を含むすべてのヘッダーaccess_token、code、signatureなどの機密性の高い URL パラメーターpassword、otp、cvv、client_secretなどのボディのフィールド- JWT、Luhn チェックを通るカード番号、秘密鍵、そして Stripe、AWS、GitHub、Slack、Google、OpenAI、Anthropic の API キー
リクエスト ID などランダムに見える値は、あえて残しています。対応するサーバーログを探すのに必要だからです。マスキングはルールベースです。アプリに独自の機密フィールドがある場合は、ワークスペースのリストに追加してください。ルールの全一覧はマスキングのページにあります。
コーディングエージェントと使う
Midge には https://midge.dev/mcp に MCP サーバーがあり、Claude Code、Cursor などのエージェントがレポートのコンソール、ネットワーク、操作を直接読み取れます。チャットにレポートのリンクを貼れば、エージェントが get_console、get_network、get_user_actions などの読み取り専用ツールで必要なものを取得します。サインインはブラウザ経由で行うか、Settings › Account › AI assistants で発行したトークンを使います。もちろん、失敗したリクエストを cURL としてコピーしたり、マスキング済みの HAR を添付したりすることもできます。どちらの場合も、データはすでにきれいになっています。
チームからより良いレポートを受け取るには
最高のツールでも、結局は何を記録するかで決まります。テスターやサポートには「バグ報告の書き方」のガイドを共有し、画面録画を案内してください。Midge は無料で、録画数は無制限、動画は最長 15 分、透かしも入りません。録画を節約する必要は誰にもありません。
よくある質問
- Midge のレポートを開くと、開発者には何が見えますか?
- 動画またはスクリーンショットと、その横にコンソールメッセージ、ネットワークリクエスト、ユーザー操作、デバイス情報が時系列で並びます。リクエストにはヘッダー、ボディ、ステータスコード、タイミングが表示されます。
- 失敗したリクエストを再実行できますか?
- はい。記録されたリクエストはどれでも cURL コマンドとしてコピーできます。認証ヘッダーと Cookie は伏せられているので、実行前に自分のテスト用アカウントのトークンを入れてください。
- Midge のレポートを公開 Issue や AI チャットに貼っても安全ですか?
- Midge はパスワード、カード番号、トークン、Cookie、既知の形式の API キーをアップロード前に取り除きます。マスキングはルールベースなので、珍しいものは確認してください。ただ、よくある機密情報はすでに取り除かれています。
- 自分のデバッグに Midge を使ってもいいですか?
- はい。自分で見つけたバグを録画しておくと、チームメイトに渡すときも、あとで戻ってくるときも、ログがそのまま残っていて便利です。