インサイトは診断機能が SIM の状態や セッション 履歴などをもとに作成されます。インサイトをもとに、どの部分に問題があったかや対処についてのヒントを確認できます。
インサイトのパラメータ
診断機能で提示されるインサイトには ID・カテゴリ・重要度・メッセージ・参考 URL が付与されます。
- : 各インサイトに振られる一意の ID
- : どの部分で問題があった・問題がなかったかのカテゴリ
- : 以下の 4 段階。
- : 該当カテゴリで問題があった
- : 問題の要因となる可能性がある
- : 該当カテゴリで問題があったが、他のカテゴリで問題があったまたは問題がなかったため重要ではない
- : 該当カテゴリで問題がなかった
- : リクエストに応じて日本語・英語のメッセージ
- : 対処のヒントとなるドキュメントの URL
インサイトの一覧
| インサイト ID | カテゴリ | 重要度 | メッセージ (日本語) (*1) | 備考 |
|---|---|---|---|---|
| INS0001 | SIM | ERROR / INFO (*2) | 現在 SIM は休止中状態です。ユーザーコンソールから使用開始してください。 | |
| INS0002 | SIM | ERROR / INFO (*2) | 現在 SIM は利用中断中状態です。ユーザーコンソールから使用開始してください。 | |
| INS0003 | SIM | ERROR / INFO (*2) | 現在 SIM は解約済みです。再利用はできません。SIM の新規調達を検討してください。 | |
| INS0004 | SIM | NONE | 現在 SIM は準備完了状態です。SIM からセッションが作成されれば通信できます。 | |
| INS0005 | SIM | NONE | 現在 SIM は利用開始待ち状態です。SIM からセッションが作成されれば通信できます。 | |
| INS0006 | SIM | NONE | 現在 SIM は使用中状態です。SIM からセッションが作成されれば通信できます。 | |
| INS0007 | SIM | WARNING | SIM の状態を取得できませんでした。 | |
| INS0008 | SESSION | ERROR / INFO (*2) | 指定期間中にセッションイベントがありませんでした。オフラインだった可能性があります。 | |
| INS0009 | SESSION | NONE | 指定期間中にセッションイベントがありました。オンラインの期間があったと考えられます。 | |
| INS0010 | SESSION | NONE | 指定期間中はオンラインでした。 | |
| INS0011 | SESSION | NONE | 指定期間中はオンラインでした。 | |
| INS0012 | SESSION | WARNING | 一部のセッションの持続時間が平均から外れているようです。デバイスの稼働状況を確認してください。 | (*3) |
| INS0013 | SESSION | WARNING | IMEI ロックで許可されていない IMEI から接続されようとしていました。IMEI ロックの設定が誤っている場合は再設定してください。 | |
| INS0014 | SESSION | WARNING | MODIFIED のセッションイベントが複数確認されました。電波強度が悪い可能性があります。 | (*4) |
| INS0016 | DATA | ERROR / INFO (*2) | 指定期間中にデータの送受信がありませんでした。 | |
| INS0017 | DATA | NONE | 指定期間中にデータの送受信がありました。 | |
| INS0018 | DATA | WARNING | Private Garden を利用しています。SIM はインターネットへの直接通信ができません。 | |
| INS0019 | DATA | WARNING | VPG のインターネットゲートウェイが無効です。SIM はインターネットへ通信できません。 | |
| INS0020 | DATA | WARNING | VPG を利用しています。接続先への通信に失敗している場合は設定が正しいか確認してください。 | |
| INS0021 | OTHERS | NONE | 選択した時間内に SORACOM Status Dashboard のイベントがありませんでした。 | |
| INS0022 | OTHERS | WARNING | 選択した時間内に SORACOM Status Dashboard のイベントがありました。 |
- (*1) SORACOM CLI / SORACOM API を呼び出した場合は、英語のメッセージが返されます。
- (*2) 1 つの診断に対して ERROR は 1 つだけ返されます。同じ ID でも各カテゴリのインサイトに応じて重要度が変わります。
- (*3) 詳しくは、セッションの維持時間が平均から外れている時間帯がある を参照してください。
- (*4) 詳しくは、Modified のセッションイベントが頻発している を参照してください。
- インサイトは今後追加されます。
- メッセージや参考 URL は変更される可能性があります。
セッションの維持時間が平均から外れている時間帯がある
セッションを一定期間維持するようなユースケース (定期的に作成したり切断したりしないユースケース) の場合は、セッションイベントを正常に検知できていない可能性があります。
以下のような場合が考えられます。
- 他のセッションに比べて「Created」「Deleted」の間隔が短い場合、電波強度が悪い・デバイス側に問題があるといった要因でデバイス側で接続を行うもすぐに切ってしまうような動作が起きている可能性があります。デバイス側のログやアプリケーションの稼働状態などを確認してください。また、可能であればデバイスや IoT SIM の交換、デバイスの再起動によって事象が改善するか試してください。
- 他のセッションに比べて「Created」から「Deleted」までの間隔が長い場合、デバイスがハングするなどしてセッションを切断できておらず、通信ができなくなっている可能性もあります。この場合は、SORACOM から デバイスへの疎通を確認 (ping 送信) してください。ping 応答が確認できた場合はアプリケーションの不具合である可能性があります。
Modified のセッションイベントが頻発している
「Modified」は、デバイスの移動などが原因で、3G/LTE のセッションの更新 (ハンドオーバー) があったことを表しています。デバイスが移動していないにも関わらず Modified が頻繁に出力されている場合は、デバイスが少しでも信号強度の強い基地局とつながろうとしてパタパタと接続先の基地局を切り替えてしまっている (しかし結局電波の弱い基地局にしかつながらない) というような状況も考えられます。このような場合はデバイスの位置を移動する、接続先の通信キャリアが異なるサブスクリプションの IoT SIM に差し替える (NTT ドコモへ接続する plan-D を利用している場合は、KDDI へ接続する plan-K に変更するなど) をお試しください。