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.
Recent sessions for a SIM
For a live view of recent, closed sessions, find your SIM from the SIMs pages or using search, and open the Recent sessions tab. This page contains a data visualization of recent sessions over time, useful for understanding the connectivity behavior of your SIM.
The Recent sessions cards beneath lists out additional details about recent sessions along with commonly referenced information about the session, and details about profile changes and fallback events.
Export this session data in XLSX, CSV, or JSON formats using the Export menu in the top right of the Recent sessions card. JSON exports have additional fields not contained in spreadsheet formats.
Recent session information is also available through our REST API using:
GET https://dashboard.hologram.io/api/1/usage/data?limit=NUMBER_OF_SESSIONS_TO_RETURN&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.
Session-level data fields
-
endTimeUTC– The time (UTC) the session closed, or ended. -
startTimeUTC– The time (UTC) the session opened, or began. -
duration– The total length of time in seconds the session was open. -
isReportingWindow– Some carriers and networks report on data usage, sending all closed sessions that occured during a blocks of time. This indicates if the session was such a reporting window. -
dataUsageBytes– The amount of data used in the session. -
profileIccid– The ICCID of the profile that used data for this session. -
imei– The device IMEI, if known, shared by the network for this session. -
network– The name of the network data was passed within. -
rat– The Radio Access Technology used for this session.
View detailed SIM session history and data usage
Detailed session-level data usage for a SIM on the Usage reporting tab. The report defaults to displaying all data usage for the SIM's current billing period, broken down by session, network, profile, and day.
Note: Data within our detailed data usage reports refresh hourly, and may not contain the most recent sessions for a SIM.
- First find your SIM either from the SIMs pages, or search for the SIM in the top navigation.
- After opening the SIM, open the Usage reporting tab.
- Hover over any card in the report to export all records to a variety of formats including
XLSX,CSV, andPDF.