Reporting endpoint - Mobile logs

Overview

Organizers can now easily up-to-date exports of all device data of Mobile logs for analytics, compliance, and operational needs. This is essential for analytics, troubleshooting, compliance, and operational monitoring.

This is only available to organizers using Spectator V4. See Spectator V4 for more information.

Be mindful of the volume of data involved! Please try to focus on date range as short as possible.

If you have significant volume of data to analyze, Excel and Power BI desktop are NOT the right tools. In those contexts, direct API integration or Power BI services with incremental refresh activated MUST be used.

Endpoint

The endpoint to fetch mobile logs is:

/organizer/report/mobile-logs

Parameters

mobileAppId (required): specify the applicable application identifier

from (required): Start of date range

to (required): End of date range

logLevels (optional): log level (INFO, ERROR, WARNING).

actions (optional): list of logged actions

limit (required): maximum number of results to extract, maximum allowed value 10’000

paginationKey (optional): if not provided, the system will return the first page. Use the nextPageKey from the previous call to get the next page.

Data returned

pagination

pageSize

integer

Number of items returned in this page

nextPageKey

string

Key to fetch next page

result

List of devices

mobileLogId	string Mobile Log ID
timestamp	string($date) Date to show log
spectatorId	string Spectator ID
deviceId	string Device ID
os	string Device Platform
osVersion	string Device version
appVersion	string Device’s app version
mobileAppId	string Application ID
ticketNumber	string Ticket Number
beaconName	string($date) Beacon Name
logLevel	string Log level
message	string Log message
action	string Action being logged