Error Log

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.

ErrorLog.png<

Understanding Errors

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:

Request

The type of request that was made and the endpoint it was sent to.

Sender

The name and account of the Activity Provider credentials used to make the request. We recommend you create separate Activity Provider credentials for testing than you use for any real data.

Statements

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.

Archiving Errors

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.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

If you can't find what you need or you want to ask a real person a question, please contact customer support.