In this article we will show you how to use and review the surveyor support section.
To be able to see this node you will need have the proper permissions, ask your organization administrator to give you access using the Security Node to a section called 'Surveyor Support'
In the main Node please navigate and open the 'Surveyor Support' -> 'Device Logs' option
Double clicking on the 'Device Logs' a window will open on the right side with the logs sent from the surveyors devices, in the 'DeviceType' you will see if it was sent from Android or PC Device and under 'Type' you will see the following:
1. Application Log
Please note: As in many other screens in SurveyToGo you can drag and drop the different fields to filter the results shown
1. Application Log
This log is the execution log that holds the following information:
- Device Information: Manufacturer, Model, Kernel etc. (Red)
- STG Android version on the device (Blue)
- Surveyor name, organization and SID (if a user was logged in while sending the logs) (Blue)
- Other SurveyToGo Options Information: Proxy, AutoSave, Date & Time, Locale, Batch Size, AutoSync Options etc. (Purple)
- GPS & Network information
- Exceptions related to syncing (results/Surveys/Attachments), Connectivity, loading surveys etc - are highlighted in Yellow.
Please Note: The log will always show the most current date at the end so if you know the date and time of the issue please scroll all the way down and then scroll up to find the relevant date.
Common Errors: If you are unsure of the error or need further assistance understanding the logs please send an email to our support firstname.lastname@example.org
|There is a problem with the script described in the error it is incorrect or there is an issue executing it||Review the function in the survey:
|Error while syncing surveys. Exception||Issues with syncing surveys to the device||
|Error creating Subject Result HTML|
|DownloadFromUrl - https://stg.dooblo.net/ws/android/stg_1.32.315.2.apk Exception: Read error: ssl=0xf45c6880: I/O error during system call, Connection timed out
||Issue downloading APK file||Connection timeout, try to download again|
|Exception: Exception :System.Exception: Could not load survey.
System.MissingMethodException: Method not found: 'Void SurveyToGo.Logic.Survey.set_SurveyFlags4(Int64)'.
|Error when trying to load a survey with a function or feature that is not supported in the STG version used on the device||Click here to send an email to support|
|Results Add Failed[Not enough credits in your account. Contact administrator.]||Error when there are not enough credits for the organization||Need to purchase additional credits for the organization.|
|ULCallFunction::HandleQuestionEnter_7 Exception: java.lang.StackOverflowError||Error when reaching question 7||Issue with the script of either the start script of Q7 or end script of Q6|
2. The Activity Log
Double click on the activity log will open the logs details
Reading the log and understanding it:
The logs have 2 different Tabs:
1. Main Details - Will provide an overview of the surveyors/interviews/Attachments collected on the device.
The Main Details screen is split to 2 sections:
1.1. Summary - Summarizes the total interviews per Survey/Surveyor that were conducted on the device, including a breakdown of how many were Uploaded/Canceled/Deleted/StillOnDevice.
1.2. Log - Will list more information on each Interview - such as: If the subject was Test or Deleted, DeviceIndex, Attachment Information etc.
2. Raw Data - Will provide step by step activities actions on the device for each interview, for example: We can see that DeviceIndex - D1508066-11 started at 31/01/2017 08:41:41AM and then cancelled manually on 31/01/2017 09:01:43 and you can see on the right in the comment column in which question it was canceled.
Please Note: As in other SurveyToGo Grids both in the 'Main Details' and the 'Raw Data' you can drag and drop the fields to filter the results showing.