When a device connects to a mobile network, Soracom creates a record of the event (known as a "Session Event") containing various information about the connection such as the date and time of the connection, the event type (Created when connecting, Deleted when disconnecting, and Modified when the connection details change), the name of the network operator, the country and cell ID where the device is located, and the IMEI of the device (if reported by the network operator). This information can be helpful for checking device behavior and troubleshooting some connection issues.

Previous Session Event behavior

The Session Event history can be viewed from the User Console or retrieved using the following APIs, each of which previously had the following retention periods:

• Sim:listSimSessionEvents (used by the New SIM Management view in the User Console) - 14-day retention period
• Subscriber:listSessionEvents (used by the Old SIM Management view in the User Console) - no retention period (all session event history can be retrieved)

What has changed

With this update, the retention periods for these APIs have been modified as follows:

• The Sim:listSimSessionEvents retention period has been increased to 32 days (1 month + 1 day)
• The Subscriber:listSessionEvents retention period has been reduced to 32 days

Once a Session Event exceeds the retention period, it is archived and cannot be viewed on the User Console. Similarly, when retrieving Session Event history from the API, you will no longer be able to access older events that have exceeded the retention period.

Effective date

This update has gone into effect on November 1, 2021.

For more information about SIM or Subscriber session details, please refer to the Subscriber Status documentation.

Note

Session history is currently being deleted progressively in accordance with the new retention period. During this process, session history older than the retention period may still be temporarily available.