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.
- User Types
- Only Global Admins use Data Search.
- Available on Essentials and Enterprise plans.
- Experts can use data search.
Finding Data Search
To find Data Search, click Data Search in the Data menu:
Looking at xAPI Statements
With Data Search, you can find the raw xAPI statements within your organization. Below the search options, you'll see xAPI statements. Click the arrow next to the xAPI statement summary to view the raw JSON that makes up the individual xAPI statement.
Searching for Statements
The simple Data Search has 4 options: Agent, Verb, Activity, and Statement Dates. Use the Refresh button to search for values you add to one or more of the options.
Hint: You can also press Ctrl + Enter (Option + Enter on Mac) to refresh.
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.
Viewing the statements for a specific report
At the bottom of every Watershed report there is a link that will open Data Search with a filter configured to show all of the statements that make up the reports data:
Related: Advanced Search gives you some lesser used search options that can help you narrow down to very specific statements you need. This is covered in Advanced Data Search.