Watershed is powered by moments of activity called interaction statements (or xAPI statements). Sources ranging from mobile apps to learning management systems are connected to Watershed, and as users perform actions in these sources, interaction statements are sent into Watershed. Data Search shows every interaction statement that has been sent to your Watershed account and allows you to perform complex searches to find specific ones you're looking for. It is a great tool to troubleshoot data issues.
This article consists of 4 sections:
Data Search and Error Log were discussed as part of our Product Walkthrough webinar series. Watch a recording of the webinar for a comprehensive look at application and setup of the feature.
Each interaction statement references a certain action performed by an individual. Here's an external resource that takes a deep dive into how people are identified in interaction statements. The Agent search allows you to search for all of the statements related to specific individuals. There are three different options for agent search:
- mbox: The mbox search allows you to find people by their email address. Note: this will only find statements that specifically have the users email address in the mbox field.
- account: In many interaction statements, the person performing an action is identified by a unique identifier for a given system, say Twitter.com, and their unique representation on that system, for instance their “Twitter handle”. When choosing the account option, you're given the options to search for Name and Homepage. In the Twitter example, the Name would be the user's account login, and the Homepage would be http://www.twitter.com/. You might need to find an example statement that uses account to identify people before actually using this search.
- name: This will search for all interaction statements associated with a particular name, regardless of whether the person is associated with an mbox or account in the statement.
In each interaction statement, verbs are represented by IDs and they are paired with a display name. There are two different options for verb search, and they represent either the ID or the display name:
- id: Search for all verbs that match the ID you choose.
- name: Search for the actual verb's name to pull up all statements with that verb.
In each interaction statement, activities are represented by IDs and they are paired with a display name. Activities can also have a short description in interaction statements. There are three different options for activity search, and they represent the ID, the display name, or the description:
- id: Search for all activities that match the ID you choose.
- name: Search for the actual activity's name to pull up all statements with that activity.
- description: Search for a full description or part of a description with the description search.
Two different dates are associated with every interaction statement, and you can search for date ranges associated with either date. Use the Since box to choose the beginning of the range and the Until box to search for the end of the range. If you only choose a Since or Until, it will search for all dates with the one condition you chose.
- stored: The stored date is the date that the statement was added to Watershed.
- timestamp: The timestamp is when the activity that generated the statement actually occurred. If the data is being sent to Watershed in real time, the stored and timestamp dates should be very close, but if you're importing legacy data or the data does not come into Watershed in real time, the dates could be different.
Advanced Search gives you some lesser used search options that can help you narrow down to very specific statements you need. 6 additional options come with Advanced Search: Statement ID, Registration ID, Related, Format, Card Filter, and Query. Use the Refresh button to search for values you add to one or more of the options (including options from Simple Search).
Use the Statement ID search to find an individual statement. This is useful for troubleshooting with a team.
These flags are associated with behavior as laid out in the xAPI specification and will find people related to users you search for if the Related Agents box is checked and related activities if the Related Activities box is checked.
Searches for format as identified by the xAPI spec. It's likely you'll never use this.
Paste in the Advanced Configuration from a card filter to search for all statements that would be used to get the data for the card.
See below for more information about queries.
This article is currently being updated. Until it is complete, check out our Product Webinar or reach out to us with any questions.
As part of our Product Walkthrough webinar series, David Ells gave us a a comprehensive look at Data Search and Error Log. Check it out below: