Fiddlerを使用したウェブサービスリクエストの監視

AlanRex1

<\/HEAD>

前回のブログ記事<\/A>で、私の尊敬する同僚でありボードゲームのライバルでもあるKelly Gerrow-Wilcoxが、ブラウザに内蔵された開発者ツールを使ってウェブブラウザのトラフィックをキャプチャする基本について説明しました。 しかし、ArcGIS Pro、ArcMap、またはその他の非ブラウザクライアントでサービスを利用している場合はどうでしょうか？ ここで登場するのがウェブトラフィックキャプチャツールです。 無料のツールは多数あり（例えばFiddler<\/A>、Wireshark<\/A>、Charles<\/A>など）、ユーザーは自分のコンピュータからウェブトラフィックをキャプチャできます。 このブログではFiddlerを使ったHTTP\/HTTPSトラフィックのキャプチャに焦点を当てます。 私はFiddlerを選んだ理由は、その比較的シンプルなインターフェースとEsriテクニカルサポート内での広範な採用によるものです。 <\/P>

<\/P>

<\/P>

基本：ダウンロード、設定、およびレイアウト<\/STRONG><\/H2>Fiddlerはこちら<\/A>からダウンロードできます。 インストール後、唯一重要な設定はHTTPS経由のトラフィックをキャプチャできるようにすることです。これを行います。<\/P>

1. Fiddlerを開き、[Tools] > [Options]に移動します<\/LI>
2. 開いたペインで、Capture HTTPS CONNTECTs<\/STRONG>とDecrypt HTTPS traffic<\/STRONG>にチェックを入れます。（これはHTTPSを使用して送信されるリクエストをキャプチャできるようにします。HTTPSは徐々にですが確実にHTTPに代わってウェブ上でデータ転送のプロトコルとなっています）。 <\/LI><\/OL><\/P><\/P><\/P><\/P><\/P>モバイルデバイスからネットワークトラフィックをキャプチャする必要がある場合は、追加の設定が必要です。 モバイルデバイスとFiddlerがインストールされているマシンは同じWi-Fiネットワークを使用している必要があります。 以下のドキュメントにはモバイルトラフィックをキャプチャする手順が記載されています:<\/P>

http:\/\/docs.telerik.com\/fiddler\/Configure-Fiddler\/Tasks\/ConfigureForiOS<\/A><\/LI>http:\/\/docs.telerik.com\/fiddler\/Configure-Fiddler\/Tasks\/ConfigureForAndroid<\/A><\/LI>http:\/\/docs.telerik.com\/fiddler\/Configure-Fiddler\/Tasks\/MonitorWindowsPhone7<\/A><\/LI>

<\PRE><\P>Fiddlerアプリケーション自体は主に2つのセクションに分かれています；Web Sessionリスト<\STRONG>ともう一つのペイン（公式名称が見つからなかったため、このブログではDetails pane<\STRONG>と呼びます）。 <\P><\P>Web Sessionsペインにはクライアントからウェブサーバーへ送信されたすべてのリクエストが順番にリストされています。 ここに含まれる重要な情報は以下の通りです:<\P>
• 使用されたプロトコルの種類（HTTPまたはHTTPS）<\LI>
• リクエストが送信されたサーバーおよび完全なURL<\LI>
• HTTP／HTTPSレスポンスコード（

これらが意味するところはこちらをご覧ください<\A>）<\LI>レスポンスボディのサイズ（バイト単位）<\LI>コンテンツタイプ（画像、テキストなど）<\LI>

 <\P>

注意：Web Sessionsペイン内の列はヘッダー部分で右クリックし、Customize Columns<\STRONG>を選択することでカスタマイズ可能です。 有用なフィールドとして以下があります:<\P>Overall Elapsed（Collection: Session Timers内にあります。これはリクエスト送信から応答受信までの全体時間です）<\LI>ClientBeginRequest（Collection: Session Timers内にあります。これはソフトウェアが最初にリクエスト送信を開始した時刻で、コンピュータの時刻を使用します）<\LI>X -HostIP（Collection: Session Flagsを選択しヘッダー名を手動入力します。これはリクエスト先サーバーのIPアドレスです）<\LI> <\P>単一のWebセッションをクリックすると、その特定リクエストに関する多様な情報がDetails paneに表示されます。 <\P> <\SPAN>

<\P>

中級：これらの詳細は何を意味している？意味はある？調べてみましょう！<\STRONG>

Details paneには多数のタブがあります。 最も有用なのは（本ブログ目的では）Timeline, Statistics, および Inspectorsです。 その他はすべて本ブログ範囲外の高度な機能です。<\SPAN>

 <\SPAN>

Statistics と Timeline タブはパフォーマンス関連問題調査時に役立ちます。例えばMap Viewerでサービス読み込みが遅い場合などです。 Timeline タブは複数リクエスト処理中どのリクエストがボトルネックになっているか特定する際に便利です。 Timeline タブ利用にはWeb Sessionsリストで複数リクエスト選択します。タイムラインは連続した「カスケード」形式でリクエスト表示し、異常に長い時間かかるリクエストはタイムライン上で長いバーとして明確に目立ちます。 <\SPAN>

 

Statistics はリクエスト開始からレスポンス受信まで各ステップごとの正確な時間を表示します。この詳細表示は単一リクエスト処理中どこがボトルネックか特定する際に有用です。例えばすべてのステップが数秒未満なのに ServerGotRequest と ServerBeginResponse の間だけ数秒間隔がある場合、それはサーバー側で何か遅延要因があることを示しています。

 <\SPAN>

最後に、 Inspectors タブでは大量の情報が表示され、おそらくほとんどすべてのトラブルシューティング作業はこちらで行われます。ここではアプリケーションとウェブサービス間のやり取りの詳細を見ることができます。Inspectors は主に2つのセクションに分かれています；Request情報（クライアントから送信されたリクエスト関連すべて）とResponse情報（サーバーから返されたレスポンス関連すべて）。両方ともほぼ同じ細分化されたタブ群があり、それぞれ異なる形式でリクエスト／レスポンス内容を表示します。本ブログ目的で有用なタブは以下です:<\SPAN>

• Headers: メインリクエスト以外の追加情報一覧です。セキュリティ／認証情報、データ形式、リクエスト元クライアント種別などが含まれます。ArcGIS Online トークンもここで見つけられることがあります。
• WebForms(リクエスト特有): リクエストパラメータごとの詳細とその値を表示します。例えば検索クエリ送信時にはキーワードや日付範囲などパラメータ内容を見ることができます。
• ImageView(レスポンス特有): リクエスト対象が画像の場合、その画像を表示します。特にタイルサービス関連リクエストで便利です。
• Raw: リクエストまたはレスポンス全体をテキスト形式で表示します。
black;"> <\/SPAN>JSON<\/STRONG><\/SPAN> 12; 12; 12; 12; 12; 12; 12; 12; 12; 12; 12; 12; 12; 12; 12; 12; 12; 12; JSON06060606060606060606060606060606060606060606060606060606060606060606
- JSON REST api ArcGIS Enterprise .<\/SPAN><\/LI>
• <\/SPAN>XML<\/STRONG><\/SPAN> XML OGC .<\/SPAN><\/LI><\/UL><\/P><\/P>高度な内容：それは素晴らしいですね、Alan。ですが、この情報を実際にどう活用すればいいのでしょうか？<\/STRONG><\/SPAN><\/H2>どのようにネットワークトラフィック情報を使うかは、あなたが何を学びたいか、または解決したい問題によります。ネットワークトラフィックを確認することで、問題の場所や内容を特定するのに役立ちますが、解決策を教えてくれるわけではありません。ここで重要なのは、あなたのアプリケーションやウェブサービスの知識、そして最終手段としてのウェブ検索です。以下は、直面している問題を特定するための一般的な例です：<\/SPAN><\/P> <\/SPAN><\/P> <\/SPAN>Web Sessions ペインで HTTP/HTTPS のレスポンスコードを確認してください。200以外のコードは調査する価値があります（必ずしも問題とは限りませんが、確認する価値があります）。再度、<\/SPAN>こちらにこれらの意味の説明があります<\/A>。200レスポンスでもエラーメッセージや他の有用な情報が含まれていることがあります。<\/SPAN>サーバーからの304レスポンスはクライアント（ウェブブラウザ、ArcMapなど）がキャッシュを使用することを促し、そのためFiddlerはサーバーからの完全なレスポンスを実際にはキャプチャしていません。重要なリクエストで304レスポンスがある場合は、シークレットモードで再試行するかクライアントのキャッシュをクリアしてください。<\/LI> <\/SPAN>401または403レスポンスは通常サーバーが何らかの認証を要求していることを意味します。例えば、公開されているウェブマップ内で共有されていないフィーチャサービスを特定するのに役立ちます。<\/SPAN><\/LI> <\/SPAN>504レスポンスは通常タイムアウトを意味します。上記で述べた, , 列と組み合わせてパフォーマンス問題のトラブルシューティングに使用してください。
  
  <\/SPAN><\/LI><\/UL><\/LI> <\/SPAN>問題のあるリクエストが見つからない場合は、Raw, JSON, XML タブを開いてレスポンス内のリクエストをスクロールしながらエラーが返されているものを探してください。<\/SPAN> <\/SPAN>Raw, JSON, XML は同じ情報を異なる形式で表示しています。<\/SPAN><\/LI> <\/SPAN>エラーが発生した場合、レスポンスに記載されたエラーは使用しているアプリケーションのユーザーインターフェースよりも詳細なことがあります。<\/SPAN><\/LI><\/UL><\/LI><\/UL><\/SPAN><\/P>無関係なリクエストを無視する方法を見つけましょう!!<\/STRONG>ネットワークトラフィックのトラブルシューティングで最も困難な要因の一つは、些細な操作でも送受信されるリクエスト数の多さです。以下は不要なリクエストでログが散らからないようにするための戦略です。関連情報がキャプチャされていないと分かっている場合は Capture をオフにします（ファイル > Capture Traffic のチェックを外す）。<\/LI>不要なブラウザウィンドウやバックグラウンドプロセスは閉じてください。<\/LI>Fiddler が調査対象と関係ないトラフィックをキャプチャしている場合は、Web Sessions で該当セッションを右クリック > Filter > フィルターしたいセッションパラメータを選択して除外してください。<\/LI>不要なリクエストが多数キャプチャされている場合、それらを選択して削除してください。<\/LI>iddler を特定アプリケーションからのみリクエストキャプチャにターゲット設定できます。「Any Process」ボタン（小さな標的アイコン隣）をクリックし、そのままマウスボタンを押し続けてからキャプチャしたいアプリケーション上で離します。例えば ArcMap から来る全トラフィックだけキャプチャしブラウザ関連トラフィックは無視するといった使い方が可能です。 <\/LI><\/UL><\/LI><\/UL>

\n

 

\n

問題に関連するリクエスト(複数可)を特定したら、以下のヒントが実際の問題判別に役立ちます。

\n

\n
• 問題となるリクエストが特定できたら、そのリクエストの性質について考え次のステップ判断に役立ててください。
\n
\n
• サービス基本メタデータへのリクエストでしょうか？ (例：https://sampleserver6.arcgisonline.com/arcgis/rest/services/SampleWorldCities/MapServer?f=json) サービス(またはサーバー)自体に問題がある可能性があります。
\n
• サービス自体は正常応答しているが単一クエリやタイル、ジョブリクエストだけ失敗していますか？ (例：http://sampleserver6.arcgisonline.com/arcgis/rest/services/SampleWorldCities/MapServer/export?dpi=96&transparent=true&) データや特定リクエストパラメータに問題がある可能性があります。
\n
• サービスへのすべてのリクエストが失敗していますか？ サーバー全体がダウンまたはアクセス不能かもしれません。
\n
\n
• Web Session を右クリック > Replay > Reissue and Edit で任意リクエスト再送可能です。
\n
\n
• 特定ヘッダーやリクエストパラメータ問題切り分けに有効です。WebForms や Headers の情報を書き換え問題解決や再現確認に使えます。
\n
• 成功しているリクエストと失敗しているもの両方あれば成功側からヘッダーや WebForms パラメータを一つずつコピーし失敗側へ適用してください。動作すれば原因パラメータ／ヘッダー特定完了です。
\n
\n
• Web Session を右クリック > Replay > Reissue Sequentially で連続再送可能です。
\n
\n
• 断続的発生問題捕捉に便利です。20〜30回自動送信し狙った問題発生確認できます。
\n
\n
• Web サービス クエリー リクエストはブラウザ上でユーザーフレンドリーなインターフェースで閲覧可能です。簡単に調整・再送信できます。ブラウザで閲覧するには：
\n

\n

\n
1. 該当クエリー セッション右クリック
\n
2. コピー > URL コピー
\n
3. ブラウザ ウィンドウへ貼り付け
\n
4. URL 内 "...f=json..." 部分を "...f=html..." に変更
\n
5. [Enter] キー押下しページ表示
\n

ウェブトラフィックに関連するGISの問題ですが、これらは役立つツールです。少し練習すれば、この種のソフトウェアを利用してGISアプリケーションでのウェブサービスへのアクセス時にさまざまな問題を解決するのに役立ちます。

良いFiddler（または一般的なネットワークトラフィックログ）に関するヒントはありますか？コメント欄に自由にお書きください！

RuiMenezes

Hi Alan

Thank you very much for your inputs.

I believe it is an IT "situation" but I want to gather as much info as possible.

I'm using fiddler to troubleshoot ArcGIS Pro so let's see how it goes.

Once again, thank you very much!

Cheers, 

Rui