Skip to main content

​
Where can I find data usage reports for a single SIM?

Find your SIM from the SIMs pages or using search. The Recent sessions tab contains a live view of recent sessions. The Data usage tab contains a detailed historical reporting.

​
Recent sessions

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.
Recent sessions chart showing session activity over time
Export 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.
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.

​
Data usage reports

Detailed session-level data usage for a SIM is found in the Data usage tab. These reports default to displaying all data usage for the SIM’s current billing period, and mirror the fleet-level data usage reporting available in the Usage section of your dashboard.

​
Data usage details

Find summarized data usage within the selected date for a SIM card by network, profile, or day to understand overall data usage behavior and connectivity changes, and to identify possible device configuration problems from zero-byte sessions.
Note: Data within our detailed data usage reports refresh hourly, and may not contain the most recent sessions for a SIM.
  • Data usage by network - Total data usage broken down by network and profile.
  • Data usage by profile - Total data usage by profile, especially useful for SIMs with multiple installed profiles and Outage Protection.
  • Data usage by day - Total data usage broken down by day.
Single SIM data usage details report

​
Key metrics and terms

​
Data usage for range (MB)
Total data usage for the selected date range in a readable format.
​
Data usage for range (bytes)
Total data usage for the selected date range in bytes.
​
Productive sessions
Total number of closed sessions in which data was passed through a network.
​
Zero-byte sessions
Total number of sessions in which no data was passed through a network, indicating possible device configuration issues.
​
Outbound SMS
Total number of device-originated SMS messages sent from the SIM that count toward a SIM’s SMS limit.

​
Location history report

Detailed data usage broken down by location with a map of approximate device location. Data usage is categorized by region, country, network, tower, and latitude and longitude.

​
Session history report

Detailed session-level historical data usage information for a SIM. Detailed data and filtering helps you identify exact issues and pinpoint exactly where and why problems occurred. Single SIM session history report

​
Field descriptions

​
End time (UTC)
Date/time in UTC the data session ended. Data usage reporting references this date as when data was “used” and billed.
​
Start time (UTC)
Date/time in UTC the data session started.
​
Duration (seconds)
Duration in seconds the session lasted.
​
Data usage
Total data usage for the session in a readable format.
​
Data usage (bytes)
Total data usage for the session in bytes.
​
Type
Session or reporting windows if the carrier returns data in timed blocks.
​
Network
Name of the network used to pass data.
​
RAT
Radio access technology used.
​
Country
Country the cellular tower was located within.
​
Tower ID
Cellular tower ID as returned by the carrier, if provided.
​
Approximate lat/long
Crowdsourced tower location, if provided.
​
Profile ICCID
ICCID of the connectivity profile used to connect.
​
Profile name
Name of the profile used to connect.
​
SIM ID
ID of the SIM card.
​
IMEI
IMEI of the modem the SIM card connected through, if provided by the carrier and network.
​
Data plan name
Data plan active on the SIM at the time the session closed, useful for identifying when a change in rates occurred.

​
Data usage reporting using the REST API

Limited data usage reporting is also available through the REST API. The /usage endpoints retrieve usage per profile using the link ID found in the Profiles tab.

List recent data sessions

List recent data sessions GET /usage/data

List total usage for billing period

List total usage for billing period GET /usage/data/monthly

List outbound SMS usage

List outbound SMS usage GET /usage/sms

Single SIM details page

Read more about the SIM details page and all the information you can find there.

SIM actions

Learn more about the actions you can take on a single SIM.