View a SIM's recent sessions

Tracking your account's overall data usage is easy using your dashboard's Usage page as instructed on this guide. However, you may need more in-depth information on a single SIM's sessions and data usage for troubleshooting.

 

Session information in the SIM page

1. To find session-level data usage for a SIM, open its details page either from the SIMs pages, or search for the SIM in the top navigation.
2. After opening the SIM, open the Data usage tab. The report will show you a graph of up to 150 recent sessions, and a table of all closed data sessions for the current SIM in the selected date range.
   

   Note: This report defaults to the last 30 days of data usage and does not currently match the SIM's billing period.

   
   
   
   
3. Open the three-dot overflow menu at the top of the Sessions card to export all visible session data to a number of formats including XLS or CSV.
   
   
   
4. Alternatively, open the three-dot overflow menu at the top of the report the entire report to a PDF or CSV.
   

Recent sessions for a device

Open a device's page and scroll down to the Recent data sessions 

Pressing the Export JSON button on the top right will open up a new tab with JSON information on the latest 100 sessions the SIM had. Pro tip: Mozilla's Firefox browser automatically formats and color codes JSON making it a breeze to read. 

 

Session-level data fields

• linkid - One of your SIM's identifiers that represents the profile on the SIM card.
• record_id - The identifier for that specific session
• session_begin - The session start's timestamp (UTC)
• timestamp - The session end's timestamp (UTC)
• bytes - The amount of data used in the session
• imei - The IMEI identifier for the modem the SIM is in
• imeisv - The IMEISV (IMEI + 2 final digits for software version) identifier for the modem the SIM is in
• cellid - The identifier for the cell your device is operating in
• lac - The location area code for the base transceiver station used
• network_name - The name of the carrier the SIM was on during the session

This information is also available through our REST API using:

GET https://dashboard.hologram.io/api/1/usage/data?limit=Number_of_sessions_you_want&linkid=Your_SIM's_linkid

Note: For your security, Hologram only operates with session metadata. If you want to dive even deeper into your usage you'd need to use a device side network analyzer tool like tshark or bmon.