Markers
Markers are key/value state that exist on a SIM. Markers are automatically applied to SIMs based on the device the SIM is used in or the state of the SIM itself.
Both the aggregate and time series usage APIs can query usages by markers. The aggregate API accepts marker keys and returns usages grouped by all of the values for the given key. The time series API accepts both a marker key and value and returns the daily usage for the given key/value.
Markers are temporally bound to usage records at a daily granularity. If a marker exists on a SIM over a time range, it will always exist on the SIM for that time range.
Valid marker keys are listed in the table below. Many of these are only available when the SIM is inside a Mason device.
Marker key | Description |
---|---|
imei | The imei associated with the SIM |
device-group | The Mason device group the SIM is deployed to |
device-uuid | The Mason device uuid the SIM is in |
device-type | The Mason device family the SIM is in |
incremental | The Android incremental build the device is in |
carrier | The carrier the SIM is connected to |
mnc | The mobile network code the SIM is connected to |
mcc | The mobile carrier code the SIM is connected to |
mnc-mcc | The combination of the mobile network and mobile carrier codes the SIM is connected to |