Skip to content
msimoneau edited this page Jun 24, 2019 · 1 revision

Beiwe ios_log documentation -Intended use: troubleshoot app problems

IOS_LOG Events

HEADERS

launchId

unique ID for this app launch. Changes when app terminates and is restarted.

memory

Approx. number of megabytes app is using. May fluctuate, but should not steadily increase forever.

battery

Battery percentage at time of this event

event

The type of event occuring

msg

Human readable msg for this event

d1-d3

Additional data, specific to each event type and outlined below.

d4

Sequence number of this event. Starts at zero and increments for each event logged until the app is restarted, at which time it resets to zero.

Should not be any gaps in the sequence. If there are, it represents events that somehow did not get logged into ios_log

Event Types

launch

App was launched

d1

Reason app was launched. Will contain "location" if app was launched in the background due to significant location change.

collecting

App is now collecting data

stop_collecting

App has stopped collecting data

foreground

App was brought into the foreground

background

App was put into the background

terminate

OS is about to terminate the app. Not always logged, as sometimes OS terminates without any notification.

memory_warn

OS is requesting app releases as much memory as possible

locked

OS has locked the keychain (phone is locked)

unlocked

OS has unlocked the keychain (phone is unlocked)

audio_save_closing

An audio file has completed saving and is being closed.

d1

Filename of audio file

audio_save

The save button was pressed on an audio file

audio_save_fail

There was a failure while trying to save the audio file to the filesystem.

d1

String describing the error

uploaded

A data file was succesfully uploded.

d1

Filename of uploaded file

upload_file_failed

A data file failed to upload

d1

Filename of uploaded file that failed

upload_complete

Finished uploading a set of data files

d1

Number of files uploaded

upload_incomplete

Upload completed but not all (or any) files were uploaded.

d1

The size of the data files still left to be uploaded

upload_incomplete

Upload completed but not all (or any) files were uploaded.

d1

The size of the data files still left to be uploaded

purge

There is a large backlog of data that was unable to be uploaded, so older data is being purged (which will result in lost data).

d1

The size of the data files still left to be uploaded

file_init

A new data file is being initialized.

d1

Name of data file

d2

false if file has no errors, true if there are errors (So should be false all the time)

d3

Error message for error (if above is true)

file_flush

All current lines of this data file are being flushed (if any)

d1

Name of data file

d2

Number of lines to be flushed

file_create

The data file is actually being created in the filesystem

d1

Name of data file

d2

false if file has no errors, true if there are errors (So should be false all the time)

d3

Error message for error (if above is true)

file_error

There was an error creating the file

d1

Name of data file

d2

Will be true since this represents an error

d3

Error message for error (if above is true)

poll_service

Polling to see if data needs to be uploaded or new surveys checked.

set_timer

Next timer to check for services/data collection is set

d1

Number of seconds when timer will fire

gps_on

GPS data collection starting

gps_off

GPS data collection stopping

accel_on

Accelerometer data collection starting

accel_off

Acceleromter data collection stopping

powerstate_on

Power state data collection starting

powerstate_off

Power state data collection stopping

proximity_on

Proximity data collection starting

proximity_off

Proximity data collection stopping

gyro_on

Gyro state data collection starting

gyro_off

Gyro state data collection stopping

magnetometer_on

Magnetometer data collection starting

magnetometer_off

Magnetometer data collection stopping

devicemotion_on

Device motion data collection starting

devicemotion_off

Device motion data collection stopping

reachability_on

Reachability data collection starting

reachability_off

Reachability data collection stopping