When implementing xAPI tracking in a product or testing a data source developed by somebody else, it can be helpful to see a record of any error messages for xAPI statements rejected by Watershed. The Error Log page allows you to do just that.
Please note: You’ll need to be logged into Watershed as an admin to access the Error Log page.
This article consists of 4 main sections:
Getting to the Error Log
To access the Error Log, choose Error Log from the Data menu.
Errors are recorded when Watershed receives an interaction statement (xAPI statement) batch that contains an invalid statement. They explain the reason why the statement was rejected so that a developer can fix the problem.
Please note: The Error Log normally only records errors relating to xAPI statements. Errors relating to invalid authentication credentials, incorrect endpoint URLs or requests that do not contain statements at all may not be recorded here.
Let’s look at the information available for each error.
The screenshot above shows two errors, one of which has been expanded to show more detail. Errors are listed with the most recent first. Unexpanded errors include the date and time that the error was recorded and the error message that was returned. Expanding an error also displays the following data:
The type of request that was made and the endpoint it was sent to.
The complete JSON of the statement(s) included in the request.
Search and Filters
Data sources should not normally generate errors on an ongoing basis, so you can normally simply look at the most recent error messages during development or testing of a particular data source. If you need to find a specific error or need to look back to a particular date and time, you can use the text search and date filters to filter errors.
To search for a word or term, simply enter it into the search box. This will filter and highlight errors that contain the term in any of the fields, including the error message and statement itself.
To filter by a date range, simply click in the Since timestamp and/or Until timestamp fields and select dates and times using the datepicker.
Once you have dealt with an error, you can click the Archive button to move the error to the Archived Errors tab. You can also Archive all errors to clear the list. Archived errors can be viewed and unarchived at any time from the Archived Errors tab.