MENU

Soracom

Users

VPG のパケットをキャプチャする

当ガイドでは、SORACOM Peek (以降、Peek)を利用して、IoT SIM が所属する VPG のパケットをキャプチャします。当ガイドの前提は以下のとおりです。

  • SORACOM のアカウントを作成済みであること
  • デバイスが準備されており、IoT SIM で接続できること

各種デバイスでの IoT SIM の使用は 各種デバイスで SORACOM Air を使用する を参考にしてください。

ステップ 1: VPG を作成し、SIM を所属させる

現時点では、Peek は VPG に所属した SIM のパケットをキャプチャします。Peek を利用できる VPG のタイプは Type-E、Type-F です。

VPG を作成するを参照して新規に VPG を作成し、 SORACOM IoT SIM の VPG 利用を有効にするを参照してパケットをキャプチャしたい SIM の VPG 利用を有効にします。オンラインの SIM の VPG 利用を有効にするには、必ずセッションの再作成が必要です。

ステップ 2: パケットキャプチャセッションを作成する

作成した VPG の管理画面より [パケットキャプチャ] タブ > [キャプチャを開始] をクリックし、パケットキャプチャセッションを開始します。

以下のパラメータを指定し、[キャプチャを開始] をクリックします。

  • ファイル名 (PREFIX): 任意のファイル名を指定します。
  • キャプチャ時間 (秒): 最大 86400 (24 時間) となります。入力が必須です。

既にパケットキャプチャセッションが作成されている場合、別のパケットキャプチャセッションは作成できません。

パケットキャプチャセッションを SORACOM API で作成する場合は createPacketCaptureSession を使用します。

SORACOM CLI を使う場合は以下のコマンドを使用します。

soracom vpg create-packet-capture-session

ステップ 3: パケットキャプチャセッション一覧を確認する

作成した VPG の管理画面より [パケットキャプチャ] タブにて作成されたパケットキャプチャセッションが表示されます。各列の意味は以下となります。

意味
作成日時パケットキャプチャセッションの作成が要求された日時
開始パケットキャプチャセッションが開始された日時
ステータスパケットキャプチャセッションの状態です。各状態の意味は パケットキャプチャセッションの状態 を参照してください
ファイル名 (PREFIX)任意に入力されたパケットキャプチャセッションを識別する名前
キャプチャ時間パケットキャプチャセッションを取得する期間 (秒)
パケットキャプチャファイルパケットキャプチャが完了するとダウンロードリンクが取得できるようになります
削除削除できます

パケットキャプチャセッションを SORACOM API で確認する場合は listPacketCaptureSessions を使用します。

SORACOM CLI を使う場合は以下のコマンドを使用します。

soracom vpg list-packet-capture-sessions

ステップ 4: パケットをキャプチャする

作成したパケットキャプチャセッションの状態が「CAPTURING」になると、パケットのキャプチャが開始されています。

デバイスでキャプチャする通信を開始します。たとえば SORACOM IoT SIM を USB ドングルなどで取り付けている Linux デバイスであれば以下のコマンドで SORACOM プラットフォームとの疎通を確認できます。

ping -c 4 pong.soracom.io

ステップ 5: パケットをダウンロードする

作成したパケットキャプチャセッションの状態が「DONE」になると、パケットのキャプチャが完了しています。

「パケットキャプチャファイル」列の [リンクを取得] をクリックします。

次に「パケットキャプチャファイル」列の [ダウンロード] をクリックするとダウンロードが開始します。

注意
[ダウンロード]をクリックしてもダウンロードが開始されない場合、お使いのネットワークでアクセスがブロックされていないか確認してください。

ダウンロード URL を SORACOM API で確認する場合は getPacketCaptureSession を使用します。

SORACOM CLI を使う場合は以下のコマンドを使用します。この際、url パラメータ がエスケープされないよう --raw-output オプションを指定してください。

soracom vpg get-packet-capture-session

ステップ 6: パケットを解析する

パケットは pcap 形式でダウンロードされますので、各種パケットアナライザで解析できます。ここでは Wireshark を例にした解析方法を紹介します。

Wireshark は Windows, mac などで利用できます。 こちらのページよりダウンロードが可能です。ダウンロード・インストールしたら起動し、[ファイル] > [開く] より pcap ファイルを開いてください。

開いた pcap ファイルを元に、宛先やパケットの内容を調査できます。

ステップ 7: パケットキャプチャセッションを削除する

セキュリティのため、パケットキャプチャセッションは作成後 7 日で自動削除されます。手動で削除する場合は「削除」列のゴミ箱アイコンをクリックします。

VPG が不要であれば VPG を削除する を実施してください。VPG を削除されない場合、基本料金が発生します。

パケットキャプチャセッション を SORACOM API で削除する場合は deletePacketCaptureSession を使用します。

SORACOM CLI を使う場合は以下のコマンドを使用します。

soracom vpg delete-packet-capture-session