| Field | Description |
|---|
| brand | The brand of the clients device. |
| device | The codename of the clients device created by its manufacturer. |
| hardware | Name of the hardware device supplied by the Android kernel. |
| buildId | BuildID represents the installed version of the client device. |
| manufacturer | The manufacturer of the clients device. |
| model | The model of the clients device. |
| product | The product code of the clients device created by its manufacturer. |
| locationType | The method used for determination of the clients device location. |
| simNetworkOperatorName | The operators name of the sim card installed in the clients device. |
| simNetworkOperator | Almost the same as networkOperator, but it's operator which is associated with the sim card, not the network which is registered the clients device. There are of course cases when both operators are the same so then simNetworkOperator is null. |
| connectionType | The type of the clients device's connection (e.g. GPRS,3G,4G,wi-fi) |
| testType | testType defines the communication protocol used by the test The test makes a direct TCP connection using Websocket protocol with the server used for the test whenever its possible. In cases in which its not possible, the http fallback mechanism is used. (1: http, 2: https, 3: ws, 4: wss ) |
| Field | Description |
|---|
| testId | ID which uniquely identifies the measurement |
| androidDeviceId | ID which uniquely identifies the Android device. AndroidDeviceIDs are created from device's IMEI. |
| androidFingerprint | AndroidFingerprint describes the information about operating system build and version. The fingerprint can be easily modified by custom versions of Android - its not standardized. To get the most accurate information about device, it's better to rely on device hardware information fields. |
| testDate | Date and time of the measurement |
| clientIpAddress | IP address of the device in the dotted quad format. |
| downloadKbps | Result of the download measurement measured in Kbps. |
| uploadKbps | Result of the upload measurement measured in Kbps. |
| latency | Result of the latency/ping part of the measurement in milliseconds. |
| serverName | Server name used for the measurement. usually it's the name of the city/country where that chosen server is located. |
| serverCountry | Country of the chosen measurement server |
| serverCountryCode | ISO country code of the measurement server |
| clientCountry | The country where the clients device is located. |
| clientCountryCode | ISO country code of the client device |
| clientCity | City in which the user is located |
| clientLatitude | User device latitude |
| clientLongitude | User device longitude |
| ispName | The ISP name of the clients device. |
| networkOperatorName | The network operator name as it was displayed by the clients device. |
| networkOperator | Mobile Country Code (MCC) and Mobile Network Code (MNC) of the the network registered on the clients device. |
| Field | Description |
|---|
| wifiNetworkAuth | Authentification type of the clients wifi network. |
| wifiNetworkChannel | Channel number of the clients wifi network. |
| wifiNetworkRouterBrand | The brand of the clients wifi router. |
| wifiNetworkFreq | The frequency of the clients wifi network. |
| wifiNetworkSignalStrengh | The strength of the signal to the wifi base station from the clients device. |
| wifiConflictingNetworks | The number of networks which are on the same channel. |
| wifiNeighouringNetworks | The number of neighbouring networks with the clients network. |
| wifiSSID | SSID of the connected wifi network |
| wifiBSSID | BSSID of the connected wifi network |
| wifiRouterModel | Wifi router model of the wifi network which user is connected to. Not all routers support this information. |
| wifiRouterManufacturer | Wifi router manufacturer of the wifi network which user is connected to. Not all routers support this information. |
| wifiThroughput | Measured throughput between user device and connected router in Kbps |
| wifiLinkspeed | Theoretical maximum speed of the wifi for particular user device under current wifi network conditions (connected devices, signal, interference etc). This will be higher than wifiThroughput. Measured in Mbps (wifi standard) |
| wifiLatency | RTT latency between user device and connected router in milliseconds |
| wifiPacketLoss | Packet loss in % between user device and connected router |
| dhcpDNS | DHCP DNS |
| dhcpGateway | DHCP Gateway |
| dhcpIpAddress | DHCP IP address |
| dhcpLeaseDuration | DHCP Lease duration |
| dhcpNetMask | DHCP net mask |
| dhcpServerAddress | DHCP server address |
| Field | Description |
|---|
| signalCellType | signalCellType reflects the network connection type associated with the signal and cell information provided by the device. 1 = GSM, 2 = CDMA, 3 = WCDMA, 4 = LTE |
| mcc | A three digit code which defines the country where the network operator is located - Mobile Country Code. |
| mnc | A three digit code which specifies the network operator in particular country - Mobile Network Code. When its combined with mcc - Mobile Country Code - then every mobile network can be uniquely identified. |
| pci | LTE Physical Cell Identity. An integer to identify the physical LTE cell the user is connected to. The value is unique to the physical cell antennae rather than a specific cell tower. Valid values are 0 to 503. A value of 65535 or null indicates that the device was unable to return a PCI value. |
| tac | LTE Tracking Area Code. A 16 bit integer used to facilitate handoff of a device between cells. The Tracking Area Identity can be determined by prepending the MCC and MNC to the Tracking Area Code. |
| baseStationId | Base Station Id 0..65535, Integer. MAX_VALUE if unknown |
| baseStationLatitude | cdma base station latitude in units of 0.25 seconds, Integer.MAX_VALUE if unknown |
| baseStationLongitude | cdma base station longitude in units of 0.25 seconds, Integer.MAX_VALUE if unknown |
| networkId | cdma network identification number, -1 if unknown |
| systemId | cdma system identification number, -1 if unknown |
| cid | gsm cell id, -1 if unknown, 0xffff max legal value |
| lac | gsm location area code, -1 if unknown, 0xffff max legal value |
| psc | primary scrambling code for UMTS, -1 if unknown or GSM |
| asuLevel | signal level as an asu value between 0..31, 99 is unknown Asu is calculated based on 3GPP RSRP. Refer to 3GPP 27.007 (Ver 10.3.0) Sec 8.69 . |
| dbm | signal strength as dBm |
| level | signal level as an int from 0..4 |
| timingAdvance | the timing advance value for LTE, as a value in range of 0..1282. Integer.MAX_VALUE is reported when there is no active RRC connection. Refer to 3GPP 36.213 Sec 4.2.3 |
| hivexCoverageQualityScore | Indicator used to estimate coverage of mobile network via 100 score scale (0 – lowest score, 100 – highest score). The coverage estimation method takes into account various signal strength and quality characteristics including measurement from all the networks (2G/3G/4G) |
| hivexVoiceQualityScore | Indicator used to estimate quality of voice service in a mobile network via 100 score scale (0 – lowest score, 100 – highest score). The voice call quality estimation method takes into account (per location) various degradations (crowdsourced from many smartphones) that potentially could affect subscriber voice call experience, e.g.: pathloss, signal-to-noise ratio, signal deviation, interference, total signal loss, ping-pong handovers, call drops. Score is calculated per each location by internal script-code |
| hivexMobileInternetQualityScore | Indicator used to estimate quality of mobile Internet service in a mobile network via 100 score scale (0 – lowest score, 100 – highest score). The mobile Internet quality estimation method takes into account: average Internet speed (Throughput), latency (network delays), Internet availability, Mobility (ping-pong effect) and probability of LTE Network dominance (as LTE is best-suitable for High Speed Internet) |
| hivexGSMRSSI | GSM RSSI represents signal strength value is 2G (EDGE) systems. Low signal level, e.g. less than -95dBm, normally indicates poor radio coverage (various degradations possible, e.g. call drop) |
| hivexUMTSRSCP | UMTS RSCP represents the signal strength value in 3G (HSPA+) systems. Low signal level, e.g. less than -100dBm, normally indicates poor radio coverage (various degradations possible, e.g. low/no internet connectivity) |
| hivexLTERSRP | LTE RSRP represents signal strength value is 4G (LTE-A) systems. Low signal level, e.g. less than -115dBm, normally indicates poor radio coverage (various degradations possible, e.g. low/no internet connectivity). |
| hivexUMTSPoorDominance | UMTS Poor Dominance indicates area of network that are prone to high interference and bad quality of service. Highly interfered areas would suffer from low throughput and high number of call drops |
| hivexLTEPoorDominance | LTE Poor Dominance indicates area of network that are prone to high interference and bad quality of service. Highly interfered areas would suffer from low throughput and high number of call drops |
| hivexRadioNetworkUnavailability | Radio Network Unavailability (Probability of No Coverage) – defines the probability for a subscriber to be camped in poor network coverage location so that no service would be available. High probability of No Coverage (Out-of-Sync) state means that being in a given location subscriber most likely won’t be able to use any of network services (e.g. set up a call or Internet connection). User experience in such locations would be critically poor |
| hivexNetworkVisibilityStatus | Defines dominant subscriber connectivity state per given location. Dominant state is selected out of two: 1. Service available (C1/S criteria fulfilled (rrc idle); In-Sync State (rrc connected)) 2. No service available (due to absence of network coverage – C1/S criteria is not fulfilled (rrc idle); Out-of-Sync (rrc connected)) |
| hivexPoorMOSEvent | Event-based indicator used to detect poor quality of voice service in a mobile network. Unlike Overall Voice Quality this KPI monitors status of voice call quality in real time. When multiple indicators direct to poor voice quality – SDK creates a poor MOS record for detected location |
| hivexPoorMOSratio | estimates % of calls (MOC and MTC) with poor MOS detected |
| hivexVoiceCalls | defines cumulative amount of voice calls made by subscribers in selected location. Number of voice calls is measured as number of times when smartphone status has been changed to OFFHOOK (i.e. voice call dialed or picked up) |
| hivexAverageDownloadThroughput | defines an average performance of radio network in terms of transmitting data in DL direction. Unlike Average Data Rate - this KPI focus on high rate bursty transmissions (keealives, text and other low rate transmissions are not taken into account). Calculation starts when application layer buffer data payload > 1024 bytes. Therefore this KPI can be fair indicator of radio network performance. |
| hivexAverageUploadThroughput | defines an average performance of radio network in terms of transmitting data in UL direction. Unlike Average Data Rate - this KPI focus on high rate bursty transmissions (keealives, text and other low rate transmissions are not taken into account). Calculation starts when application layer buffer data payload > 1024 bytes. Therefore this KPI can be fair indicator of radio network performance |
| hivexNoMobileInternetAvailable | sums up number of 1sec periods when mobile Internet connectivity was limited (i.e. ps data can not be routed to Internet (no PS connection to Apple/Google servers |
| hivexMobileInternetUnreachabilityRatio | % of time when mobile Internet was not reachable |
| hivexCallDropUMTS | event based performance indicator that counts number of call drops in 3G. After each call completion SDK defines (based on various factors during the call) whether call completed normally or with failure. |
| hivexIdleState | amount of seconds that Smartphones spent in IDLE mode per specific location. Idle mode is a state where Smartphone doesn’t have any (voice or data) connections or activity. |
| hivexCallState | amount of seconds that Smartphones spent in voice call mode per specific location. Voice call mode gets active when subscriber picks up incoming or initiates outgoing voice call (gets deactivated when voice call ends) |
| hivexDataSessionState | amount of seconds that Smartphones have spent in data (internet) session mode per specific location. Data session mode gets active when subscriber initiate internet connection (e.g. by launching a mobile application) |
| hivexCallDataSessionState | amount of seconds that Smartphones spent in multi-call state (voice and data were simultaneously active). Voice call mode gets active when subscriber picks up incoming or initiates outgoing voice call (gets deactivated when voice call ends). Data session mode gets active when subscriber initiate internet connection (e.g. by launching a mobile application) |
| Field | Description |
|---|
| youtubeInitialBufferingStartupLatency | Number of milliseconds to start streaming video (initiall buffering) |
| youtubeRebufferingTimes | Number of times the video needed buffering after initial start |
| youtubeDurationOfEachRebuffering | Array of durations in milliseconds for each instance of buffering (after initial start) |
| youtubeVideoHostname | hostname of the youtube server hosting video that has been played |
| youtubeVideoID | video ID that has been played |
| youtubeVideoPlayDuration | total length of video play in seconds |
| youtubeVideoResolution | video resolution (e.g. 1920x1080) that has been automatically selected as most appropriate for particular user device and connection |
| youtubeDownloadSpeed | maximum throughput achieved while buffering youtube video |
| youtubeQualityIndex | MOS type of score from 1-5 (with 5 being the best) to determine overall Youtube video quality, calculated based on available metrics |
| netflixQualityIndex | MOS type of score from 1-5 (with 5 being the best) to determine overall Netflix video quality, calculated based on available metrics |
| netflixDownloadSpeed | maximum throughput achieved while buffering Netflix video |
| netflixVideoResolution | video resolution (e.g. UHD,HD,SD,Low) of the Netflix video, calculated based on available metrics |
