IoT SIM の通信状況 (セッション) を確認する
IoT SIM の現在の セッション やセッション履歴を確認できます。
IoT SIM が通信できないように見えるときは
診断機能を利用 して、どの カテゴリ に異常があったかを診断してください。
IoT SIM の有効期限が設定 されている場合は、有効期限が過ぎると新規セッションが確立できなくなります。有効期限が設定されていないことを確認してください。
IoT SIM のステータス が「休止中 (inactive)」や「利用中断中 (suspended)」の場合は、セッションを確立できません。
現在のセッションを確認する
SIM 管理画面で、IoT SIM の現在のセッションを確認できます。
SORACOM ユーザーコンソール にログインし、セッションを確認する IoT SIM にあわせてカバレッジタイプを変更します。
たとえば、plan01s の IoT SIM のセッションを確認する場合は、グローバルカバレッジの表示に変更します。詳しくは、SORACOM ユーザーコンソールで表示するカバレッジタイプを変更する を参照してください。
の「オンライン」「オフライン」を確認します。
表示の意味について詳しくは、状態 (オンライン / オフライン) を参照してください。
セッション履歴を確認する
過去 32 日間のセッション履歴を確認できます。
SORACOM ユーザーコンソール にログインし、セッション履歴を確認する IoT SIM にあわせてカバレッジタイプを変更します。
たとえば、plan01s の IoT SIM のセッション履歴を確認する場合は、グローバルカバレッジの表示に変更します。詳しくは、SORACOM ユーザーコンソールで表示するカバレッジタイプを変更する を参照してください。
セッション履歴を確認する IoT SIM にチェックを入れ、
→ の順にクリックします。セッション詳細で確認できる情報は以下のとおりです。通信方式によって表示される情報が異なります。
項目 意味 現在のセッション状態 「オンライン」または「オフライン」。詳しくは、状態 (オンライン / オフライン) を参照してください。 基地局の位置 「MCC」、「MNC」、「エリアコード」および「セル ID」をもとに基地局の位置が表示される場合があります。詳しくは、基地局の位置情報を取得する を参照してください。 時刻 セッションイベント (Created、Deleted、Modified) が発生した時刻 イベント 「Created」、「Deleted」、または「Modified」。詳しくは、イベント (Created / Deleted / Modified) を参照してください。 IMEI IMEI (International Mobile Equipment Identity) サブスクリプション 利用された サブスクリプション MCC Mobile Country Code。接続している国・地域の識別番号。
例:440
は「日本」を表します。MNC Mobile Network Code。接続している電気通信事業者の識別番号。
例:10
は「NTT ドコモ」を表します。国・地域 接続している国・地域 キャリア 接続している通信キャリア (電気通信事業者) 通信方式 「3G or GSM」、「LTE」などの通信方式 エリアコード 接続している基地局のエリアコード セル ID 接続している基地局のセル ID
SORACOM CLI / SORACOM API の場合
SORACOM CLI または SORACOM API を利用しても、セッション履歴を確認できます。
- SORACOM CLI を利用するには、あらかじめ SORACOM CLI をインストールし、認証情報を保存してください。詳しくは、SORACOM CLI をインストールする を参照してください。
- SIM ID は、
soracom sims list
(Sim:listSims API
) で取得できます。
現在の通信状況 (セッション) を確認する
soracom sims get
(Sim:getSim API
) を使用します。
$ soracom sims get --sim-id ${sim_id}
{
:
"sessionStatus": {
:
"online": true,
:
},
:
}
セッション履歴を確認する
soracom sims session-events
(Sim:listSimSessionEvents API
) を使用します。
$ soracom sims session-events --sim-id ${sim_id} --from ${from} --to ${to} \
--limit ${limit} --last_evaluated_key ${last_evaluated_key}
現在のセッションは、最新のセッション履歴の event
の値を見て判定できます。セッションの意味は、状態 (オンライン / オフライン) を参照してください。
event の値 | 現在のセッション |
---|---|
Created / Modified | オンライン |
Deleted | オフライン |
- SORACOM API を利用するには、API キーと API トークンが必要です。詳しくは、API キーと API トークン を参照してください。
- SIM ID は、
Sim:listSims API
で取得できます。
現在の通信状況 (セッション) を確認する
Sim:getSim API
を使用します。
$ curl -v -X GET https://api.soracom.io/v1/sims/${sim_id} \
-H "X-Soracom-API-Key: $X_SORACOM_API_KEY" \
-H "X-Soracom-Token: $X_SORACOM_TOKEN"
{
:
"sessionStatus": {
:
"online": true,
:
},
:
}
セッション履歴を確認する
Sim:listSimSessionEvents API
を使用します。
$ curl -v -X GET "https://api.soracom.io/v1/sims/${sim_id}/events/sessions?from=${from}&to=${to}&limit=${limit}&last_evaluated_key=${last_evaluated_key}" \
-H "X-Soracom-API-Key: ${X_SORACOM_API_KEY}" \
-H "X-Soracom-Token: ${X_SORACOM_TOKEN}"
現在のセッションは、最新のセッション履歴の event
の値を見て判定できます。セッションの意味は、状態 (オンライン / オフライン) を参照してください。
event の値 | 現在のセッション |
---|---|
Created / Modified | オンライン |
Deleted | オフライン |