• ドキュメント
• SORACOM Peek
• Getting Started

Virtual Private Gateway (VPG) のパケットをキャプチャする (SORACOM Peek for VPG)

Peek を利用して、IoT SIM が所属する VPG のパケットをキャプチャします。これを、Peek for VPG と呼びます。Peek for VPG を利用できる VPG のタイプは Type-E、または Type-F です。

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

1. パケットをキャプチャする VPG の VPG 設定画面を表示します。

   VPG 設定画面を表示する操作について詳しくは、VPG の設定を変更する を参照してください。

2. [パケットキャプチャ] → [キャプチャを開始] の順にクリックします。

   

   「パケットキャプチャセッションを開始」画面が表示されます。

3. 各項目を設定します。

   項目	説明
   [ファイル名 (PREFIX)]	パケットキャプチャファイルのプレフィックス (先頭に付与する文字列) を指定します (最大 100 文字)。使用できる文字は、半角英数字 (a ～ z、A ～ Z、0 ～ 9) または記号 (_、-) です。
   [キャプチャ時間 (秒)] *	60 ～ 86400 秒 (24 時間) の範囲で指定します。

   

4. [キャプチャを開始] をクリックします。

   パケットキャプチャセッションが作成され、「パケットキャプチャセッション」画面が表示されます。

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

作成されたパケットキャプチャセッションは、VPG 設定画面の [パケットキャプチャ] タブに表示されます。表示される内容は、Peek for SIM と同様です。詳しくは、ステップ 2: パケットキャプチャセッション一覧を確認する を参照してください。

ステップ 3: パケットを送信する

作成したパケットキャプチャセッションのステータスが REQUESTED に変わったことを確認し、ステップ 1: パケットキャプチャセッションを作成する でチェックを入れた VPG に所属する IoT SIM を利用するデバイスで通信してください。

SORACOM プラットフォームにパケットが届くとパケットのキャプチャが開始され、ステータスが CAPTURING に変わります。

たとえば、SORACOM IoT SIM を USB ドングルなどで取り付けた Linux デバイスであれば、以下のコマンドで SORACOM プラットフォームにパケットを送信できます。

$ ping -c 4 pong.soracom.io

パケットキャプチャセッションを途中で停止する

[キャプチャ時間 (秒)] で指定した時間が経過する前に、パケットキャプチャセッションを停止できます。

1. VPG 設定画面の [パケットキャプチャ] をクリックし、停止するパケットキャプチャセッションの [停止] をクリックして、[停止] をクリックします。

   

   パケットキャプチャセッションが停止され、ステータスの表示が POSTPROCESSING に変わり、続けて STOPPED または DONE に変わります。

   

2. ステータスの表示が変わらない場合は、[パケットキャプチャ] タブの右上にある (リフレッシュボタン) をクリックします。

ステップ 4: パケットキャプチャファイルをダウンロードする

パケットキャプチャセッションのステータスが DONE または STOPPED になると、pcap 形式のパケットキャプチャファイルをダウンロードできます。

1. VPG 設定画面の [パケットキャプチャ] をクリックし、[パケットキャプチャファイル] の [リンクを取得] をクリックします。

   

   パケットキャプチャファイルのダウンロード URL が取得され、[ダウンロード] と表示されます。

2. [ダウンロード] をクリックします。

   

   pcap 形式のパケットキャプチャファイルがダウンロードされます。

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

ステップ 5: キャプチャしたパケットを確認する

Wireshark で pcap 形式のファイルを確認する操作を説明します。Wireshark は Windows や Mac OS で利用できるアプリケーションです。あらかじめ、ダウンロードおよびインストールしてください。

1. Wireshark を起動し、[ファイル] → [開く] の順にクリックし、ステップ 4: パケットキャプチャファイルをダウンロードする でダウンロードした pcap 形式のファイルを選択します。

2. 宛先やパケットの内容を調査します。

   

   Wireshark の操作方法について

   Wireshark · Documentation を参照してください。

SORACOM CLI / SORACOM API の場合

SORACOM CLI または SORACOM API を利用しても、VPG に所属する IoT SIM のパケットをキャプチャできます。

$ soracom vpg create-packet-capture-session --vpg-id {vpg_id} --duration 300 --prefix "vpg-peek-test"

$ soracom vpg list-packet-capture-sessions --vpg-id {vpg_id}

$ soracom vpg delete-packet-capture-session --vpg-id {vpg_id} --session-id {session_id}

$ soracom vpg stop-packet-capture-session --vpg-id {vpg_id} --session-id {session_id}

$ soracom vpg get-packet-capture-session --vpg-id {vpg_id} --session-id {session_id} --raw-output

$ curl -v -X POST https://api.soracom.io/v1/virtual_private_gateways/{vpg_id}/packet_capture_sessions \
-H "X-Soracom-API-Key: $X_SORACOM_API_KEY" \
-H "X-Soracom-Token: $X_SORACOM_TOKEN" \
-H "Content-Type: application/json" \
-d '{
  "duration": 300,
  "prefix": "vpg-peek-test"
}'

$ curl -v -X GET https://api.soracom.io/v1/virtual_private_gateways/{vpg_id}/packet_capture_sessions \
-H "X-Soracom-API-Key: $X_SORACOM_API_KEY" \
-H "X-Soracom-Token: $X_SORACOM_TOKEN"

$ curl -v -X DELETE https://api.soracom.io/v1/virtual_private_gateways/{vpg_id}/packet_capture_sessions/{session_id} \
-H "X-Soracom-API-Key: $X_SORACOM_API_KEY" \
-H "X-Soracom-Token: $X_SORACOM_TOKEN"

$ curl -v -X POST https://api.soracom.io/v1/virtual_private_gateways/{vpg_id}/packet_capture_sessions/{session_id}/stop \
-H "X-Soracom-API-Key: $X_SORACOM_API_KEY" \
-H "X-Soracom-Token: $X_SORACOM_TOKEN"

$ curl -v -X GET https://api.soracom.io/v1/virtual_private_gateways/{vpg_id}/packet_capture_sessions/{session_id} \
-H "X-Soracom-API-Key: $X_SORACOM_API_KEY" \
-H "X-Soracom-Token: $X_SORACOM_TOKEN"