Skip to main content


Scuba Docs

3.0 Release Notes

This document introduces new features included in Scuba release 3.0, as well as listing functionality to be included in coming releases, and newly resolved and known issues.

New features  

This section provides a high-level description of the new features included in release 3.0:

SSO and third-party authentication support 

Scuba 3.0 supports the following methods of authentication:

  • Azure AD authentication, with other third-party auth platforms to be supported in upcoming 3.x releases. 
  • Local authentication, which is the Scuba default.

Customizable boards and panels 

Interactive boards provide the ability to create queries that can be saved as visual panels and shared with team members. You can customize boards through adding, filtering, and rearranging panels that are updated dynamically. Likewise, you can modify queries and then save them as new panels inline. For more information, see the following:

Board and panel visualizations 

Boards and panels can display dynamic query results in the following formats. Tooltip details appear when you hover the cursor over graph data points.

  • Time view—Linear line graph of events in chronological order
  • Table view—Table display of query data results
  • Sankey view—Flow diagram the chronological path of actor events
  • Number view—Numeric values and descriptions for query results
  • Bar view—Bar chart graph
  • Stacked bar view—Bar chart graphs stacked one upon another
  • Samples—Event data for a query graph, shown in table format

For more information, see the following:

Sentence model query builder   

The sentence model query builder provides an intuitive means for defining queries. You specify selections for the query from drop-down lists. Then, the query builder automatically adds words to create grammatically correct sentences describing the query logic. 

Data and action dictionary  

The data and action dictionary provides drop-down lists of valid properties for current data and action selections. Each event property page (Events > event_property) displays a list of Common Actions for that event as well. 

Customizable event, actor, and flow properties 

You can create custom event, actor, and flow properties that act as filters and perform operations on a query. You can use multiple properties on a query, then perform iterative modifications on the properties as needed.

Persistent query history 

A query history across your session appears in the left panel of Explore view. The display provides an easily accessible intuitive reference of all the queries you've created. You can return to a query and review past results, rerun the query for updated results, or modify the query to explore new results.

Enhanced calculations for comparisons 

Scuba 3.0 provides robust sets of measures and filtering criteria for comparisons, allowing you to express the comparison of n measures as an algebraic expression. Users can add, subtract, multiply, and divide measures or numbers in the query itself without having to create a derived column. 

Flow visualization for actor path discovery 

Flows provide a visual mapping of user path discovery. You can define a flow based on an actor (shard key) with a specified number of steps. You can apply filters for each step, as well as global filters, time-outs between events, and overall maximum time of the flow. Flow results are shown as a Sankey diagram, split according to step, action, event, and other contexts.

Calendar-aligned times for month, quarter, and year 

Scuba 3.0 provides calendar-aligned times that allow you to select month, quarter, or year for relative time windows.

Share queries 

Scuba 3.0 provides the ability to copy a query URL for sharing in email, Slack messages, and other electronic communication platforms.

Coming soon! 

If you're familiar with Scuba 2.x, you may miss a few features in 3.0. No worries! The following functionality will be included in an upcoming 3.x release:

  • Activity metrics
  • Built in __day__, __hour__ functions
  • Stacked area time view
  • Pie view
  • Distribution view
  • A/B view
  • Retention view
  • Export to CSV
  • Timezone support
  • Automatic refresh for boards
  • Scheduled emails for boards

Resolved issues  

The following issues were resolved in Release 3.0.

HIG-13039 When you use SSO with your auth provider, you are given a link—that when clicked—redirects you to a shared location after login.

Known issues  

The following are known issues in Release 3.0:

  • All queries are run in GMT.
  • Board queries are only re-run when you view a board.
  • For day_of_week functionality, you must enter it directly into Explorer. 
HIG-14359 When creating an actor property based on a flow property, the preview may error out. However, the object is still functional and can be used in Explorer. 
HIG-14850 When creating an actor property, the preview may issue a query over a different time range than specified in the definition of the actor property. However, the object is still functional and can be used in Explorer. 
HIG-14963 When choosing a custom trailing window (which differs from the resolution) in the explorer and running a query that counts actors filtered to the value of a custom actor property, the query may return incorrect results.  
HIG-14555 Selecting the "is previous to state" flow operator directly from Explorer can cause a query error. To achieve this use case, run a Sankey view query and use the chart interactions. 
HIG-12336 Referencing set columns within a filter can cause a query error. 
HIG-14478 Splitting a Sankey view query by a set column can cause a query error.
HIG-14937 Splitting a Sankey view query by a DAY_OF_WEEK function expression can cause a query error.
HIG-14828   Splitting a Sankey view query by an actor property can cause a query error.
HIG-11565 Insufficient system memory can cause flow queries not to complete.
HIG-13826 You are unable to show aggregations of both actor properties and event / flow properties within the same query. 
HIG-14430 Choosing "1 year ago" to "now" in Explorer may not give intuitive results, as it selects the most recent complete year which may not include any recent data. Using "1 year ago exactly" to "now" goes back in time one year from the exact current time. This same distinction exists for all calendar time units. 
HIG-13763 When using the Edge browser, the trash can icon (to clear a section of the explorer) may not render. However, clicking to the far right of that section will still clear it. 
HIG-13664 When using the Edge browser, you may need to scroll down to the bottom of the page to see the time scrubber. 
HIG-15082 First and Last for Identifier columns will be supported in 3.1.
HIG-14830 Spaces and "." will reset your type ahead search, supported in 3.1.
HIG-14922 Typing a space in Explorer fields resets the search to anything typed after the space only.


  • Was this article helpful?