Advanced notice :
We will be upgrading wiki.geant.org from the current version of Confluence Server to the current LTS version 8.5. During the maintenance window we expect that there will be an outage of 20 minutes.
Maintenance start time: 22/10/2024 16:00 UTC. Maintenance end time: 22/10/2024 18:00 UTC.
Specification
[reportOrigin]
{
"testDeviceType": string --> typical values are "wifiprobe", "NetTest", "boomerang" to distinguish between measurement tools
"testDeviceVersion": string --> version of the tool used (e.g. 1.0)
"testDeviceId": string --> ID (e.g. MAC address) of device used for preforming the test
"testInstanceUniqueId": string --> a unique identifier for this result set
"testStartTimestamp": string --> UTC date & time when the test has been started (YYYY-MM-DD hh:mm:ss)
"testFinishedTimestamp": string --> UTC date & time when the test has been completed (YYYY-MM-DD hh:mm:ss)
}
[environment]
{
"latitude": float number, --> latitude in degrees,decimal fractional minutes (note: we do not use this information anymore, yet it cannot be empty)
"longitude": float number, --> longitude in degrees,decimal fractional minutes (note: we do not use this information anymore, yet it cannot be empty)
"altitude": float number, --> altitude in meters(it can be empty)
"locationName": string, --> tested location name (can be empty)
"testDeviceLocationDescription": string --> describes the location of the test device
"locationMethod": string, --> typical values are 'Through IP' or 'Geolocation' (note: we do not use this information anymore, yet it cannot be empty)
"wifiSurround": array --> list of SSIDs found
"accessPointVisibleSSIDCount": integer --> number of Wi-Fi cells with a normally visible SSID
"accessPointHiddenSSIDCount": integer --> number of Wi-Fi cells with a "hidden" SSID
}
[connectivity]
{
"eduroamAuthnSuccessful": string --> result of eduroam AuthN (true or false)
"ipv4Connectivity": float number --> time needed to get valid IPv4 address; -1=no connectivity;
"ipv6Connectivity": float number --> time needed to get valid IPv6 address; -1=no connectivity;
}
[performance]
{
"downloadThroughput": float number, --> download speed in KBps (note: we use one decimal digit)
"uploadThroughput": float number, --> upload speed in KBps (note: we use one decimal digit)
"ipv4LocalPing": float number, --> IPv4 ping time in ms (note: we use one decimal digit) -1 if there was no IPv4 connectivity
"ipv6LocalPing": float number, --> IPv6 ping time in ms (note: we use one decimal digit) -1 if there was no IPv6 connectivity
}
JSON message example (syntax to be verified)
[reportOrigin]
{
"testDeviceType": "Frankenprobe",
"testDeviceVersion": 1.0,
"testDeviceId": "00-11-22-33-44-55",
"testInstanceUniqueId": "13df2a-671bbfa5697-13245-67713af",
"testStartTimestamp": "2017-09-13 15:00:00",
"testFinishedTimestamp": "2017-09-13 15:02:19",
}
[environment]
{
"latitude": 38.25,
"longitude": 21.73,
"altitude": -213.45,
"locationName": "Subterranean University, Main Building",
"testDeviceLocationDescription": "rector's office, hidden behind the 'A Starry Night' van Gogh painting on the rear wall",
"locationMethod": "Differential Indoor GPS",
"wifiSurround": [ "eduroam", "drillTest", "geological_symposium" ] ,
"accessPointVisibleSSIDCount": 7,
"accessPointHiddenSSIDCount": 1,
}
[connectivity]
{
"eduroamAuthnSuccessful": true,
"ipv4Connectivity": 0.672,
"ipv6Connectivity": -1,
}
[performance]
{
"downloadThroughput": 4375.0,
"uploadThroughput": 3912.5,
"ipv4LocalPing": 4.7,
"ipv6LocalPing": -1,
"testTool": "wifiprobe"
}