ガイド

HAR を書き出す スマートフォンから

iPhone や Android でキャプチャした通信は、ダッシュボードから 2 クリックで標準の HAR 1.2 ファイルになります。リクエスト 1 件、ホスト 1 つ、端末 1 台、または手元のすべて。どの HAR ビューアにも、バグ報告にも、チームメイトへの共有にもそのまま使えます。

HAR はあらゆるネットワークツールが読める唯一の形式であり、同時にスマートフォン単体では作れないものです。Busymate DevTools は、そもそもキャプチャをスマートフォンに置かないことでこれを解決します。アプリが記録するすべてのリクエストはダッシュボードのストアに直接書き込まれるため、書き出しはそこで、全履歴に対して、ケーブルも同期手順もなしに実行されます。スマートフォンはキャプチャしてさえいればよいのです。

このガイドでは、フィードのツールバーが提供する 4 つの書き出し範囲、端末の完全書き出しに含まれるものと意図的に含まれないもの、HAR を再び取り込む方法、そして AI エージェントから同じファイルを一文で得る方法を扱います。

始める前に

必要な もの

何かをキャプチャ済みのスマートフォンと、ブラウザで開いたダッシュボード。

  • 目的のセッションをキャプチャ済みのペアリングされた iPhone または Android。VPN でも PAC モードでも構いません。

  • ボディを読める形にするには、キャプチャ時点でその端末の SSL プロキシリストに対象ホストが入っていること。暗号化されたホストはメタデータとしてのみ書き出されます。

  • 端末のサイドバーが見える状態で開いたダッシュボードのフィード。

  • 有効なトークンを含みうるファイルの置き場所。共有する前に「うまくいかないときは」を読んでください。

ステップ・バイ・ステップ

順番どおりに 進める

まず範囲、次に書き出し、そして確認。最後のステップではクリックを一文に置き換えます。

  1. 01

    スマートフォンでセッションをキャプチャする

    キャプチャをオンにし、渡したいフローを一通り実行し、きれいな区切りが欲しければまたオフにします。すべてのリクエストは発生と同時にダッシュボードに届き、後からスマートフォンから取り出すものはありません。そのとき有効だった接続モードはリクエストごとに記録されるので、書き出しには各リクエストがどう取得されたかが残ります。

  2. 02

    フィードをその端末に絞る

    端末のサイドバーでそのスマートフォンを選び、フィードにその通信だけを表示させるか、端末をあらかじめ指定したリンクからダッシュボードを開きます。検索ボックスで想定どおりのリクエストがあるか確認し(ホストやパスで絞り込み)、行をクリックしてインスペクタを開き、読めるはずのボディが読めることを確かめます。

    端末 1 台のフィードへのディープリンク
    text
    https://dash.busymate.dev/?device=<device-uuid>
  3. 03

    書き出しメニューで範囲を選ぶ

    書き出しメニューはフィードのツールバーにあります。行を選択した状態では、このリクエストだけ、そのホストへのすべてのリクエスト、そのホスト周辺のワイルドカードに一致するすべてのリクエスト、という 3 つの狭い範囲が提示されます。エンドポイント 1 つについてのバグ報告にはこれが適しています。選択なし、またはセッション全体が欲しいときは、同じメニューが端末の書き出しと全端末の書き出しを提示します。

  4. 04

    端末を書き出す — またはすべてを

    Export device は、そのスマートフォンの永続化済みエントリすべてを 1 つの HAR ファイルに書き出します。ブラウザに読み込まれている行だけでなく、全履歴をサーバー側でページ送りするので、長いセッションも完全な形で出力されます。知っておくべき点が 2 つ。フィードのフィルターは適用されません(設計上、完全なダンプです)。そして履歴の深い端末はページごとにストリーミングされるため、ダウンロードの準備に少し時間がかかることがあります。

    Export all devices はワークスペース内の全端末に対して同じことを行います。複数のスマートフォンがどう振る舞ったかが問いなら、添付すべきはこのファイルです。

  5. 05

    確認し、アーカイブが欲しければ往復させる

    ファイルは標準の HAR 1.2 なので、どの HAR ビューアでも開けます。ダッシュボードもその一つです。インポート操作で HAR ファイルを選ぶとエントリが永続化・配信され、ライブキャプチャとまったく同じ整形と検索付きでフィードに現れます。インポート時に端末フィルターが有効なら、端末名を持たないエントリはその端末に紐づけられます。

    セッションの終わりに端末の HAR を書き出し、新しいワークスペースに再インポートするのは良い習慣です。独自の保持期間を持つアーカイブコピーが残り、後から閲覧できます。

  6. 06

    同じファイルをエージェントから一文で得る

    Claude Code や他の MCP クライアントを接続していれば、あるいはダッシュボードの BusyBro からでも、書き出しはプロンプト一つです。ホストと時間枠を指定すれば、ツールバーに触れることなく、まさにその範囲に絞られた HAR ログが得られます。エージェント経由の書き出しも、他の操作と同じくロールの権限の範囲内で実行されます。

    範囲を絞った HAR 書き出しを生むプロンプト
    text
    Give me a HAR export of every request to api.example.com captured today from my iPhone.

トラブルシューティング

うまくいかない ときは

驚きの多くは、書き出しが意図的に含めるもの・含めないものに関するものです。

  • 端末の書き出しに、フィルターで隠していた行が含まれている

    想定どおりです。端末および全端末の書き出しは完全なダンプで、フィードのフィルターを無視します。狭いファイルが欲しければ行を選択し、このリクエスト・ホスト・ワイルドカードの範囲を使ってください。

  • ヘッダーはあるのにボディがないエントリがある

    それらのホストはキャプチャ時に SSL プロキシリストに入っていなかったため、メタデータしか存在しません。ホストを追加し、フローを再度キャプチャして、もう一度書き出してください。書き出しには、その時点で復号されていたものしか含められません。

  • ファイルに有効なトークンが含まれている

    含まれます。HAR は忠実な記録であり、書き出しは何も伏せ字にしません。認証情報と同じように扱い、共有前にシークレットを取り除くかローテーションしてください。構造だけ知りたいなら、BusyBro にフローの説明を頼む方が安全です。その回答ではトークンやクッキーが伏せられます。

  • インポートしたエントリが別の端末に入ってしまった

    端末名を持たないエントリは、インポート中に有効だった端末フィルターに紐づけられます。インポート前にフィルターを解除するか、意図した端末を選択してください。

  • 通信量の多い端末でダウンロードが止まっているように見える

    大きな履歴は、ファイルが提示される前にサーバー側でページごとにストリーミングされます。少し待ってください。セッションの一部だけが必要なら、範囲をホストに絞ってください。

よくある質問

よくある 質問

HAR のどのバージョンですか? 他のツールでも開けますか?

HAR 1.2、ログとそのエントリからなる標準の形式です。どの HAR ビューアでも、ブラウザの開発者ツールのインポートでも、ダッシュボード自身のインポートでも読み込めます。

スマートフォン本体から書き出せますか?

書き出しはダッシュボードで実行され、スマートフォンのブラウザからも開けます。ただ、すべてのリクエストはキャプチャされた瞬間にすでにダッシュボードにあるので、先にスマートフォンから取り出すものは何もありません。

端末の書き出しはどこまで遡れますか?

ワークスペースの保持期間内でエントリが永続化されている範囲までです。それ以上残したければセッション終了時に書き出し、アーカイブ用ワークスペースに再インポートしてください。

スマートフォンのセッションを、 誰でも開けるファイルに

スマートフォンでキャプチャし、フィードで範囲を絞り、標準の HAR を渡す。あるいはエージェントに頼む。

Ask your mate