Skip to main content


Scuba Docs

Scuba Migration Workbook

Scuba Migration Workbook
Scuba 3 introduced new paradigms for accomplishing tasks. This guide demonstrates how to perform Scuba 2.x analyses with functionality in Scuba 3 and 4. Use this guide to help you migrate your work off of a Scuba 2.x cluster onto Scuba 4.x.


Version: 3.0
  • 3.x to 2.x object and concept referenceThis article shows how specific named expressions in 2.x map to reusable knowledge objects in 3.x; how other components of Scuba have been reworked between 2.x and 3.x; and a few highlights of 2.x features that have improved in 3.x.
  • Creating a 2.x cohort as a 3.x actor propertyA cohort is a way to group actors that behave similarly or have similar attributes, enabling both behavioral and demographic segmentation. Actor properties in 3.x are similar in function to 2.x cohorts, but more flexible. Once you create an actor property, you can use it as a filter in an infinite number of queries. In 2.x, you create individual cohorts for each use case.
  • Creating a 2.x derived column with a 3.x event propertyDerived columns allow you to define new calculated columns from the data in existing (imported) data columns. This article shows you how to create a 2.x derived column using two values in an existing dataset to calculate the length of a user session. Then it shows you how to generate similar results by creating a 3.x custom event property.
  • Creating a 2.x funnel with a 3.x flowA funnel describes a journey through a series of defined steps (like registering for a service, or making an online purchase) where there is a desired goal and we want to analyze whether actors successfully reached the end goal, how long it took, and in cases where the actors did not reach the goal, where they were most likely to drop off. We run queries to count funnels that started, funnels that completed, the time spent in each step of the funnel, and visualize the process.
  • Creating a 2.x global filter as a 3.x event pre-filterThis article shows you how to create a 2.x global filter, and then create similar results using a 3.x pre-filter. A 2.x global filter is applied at the dataset level, and affects both the query itself and any underlying named expressions (knowledge objects in Interana 3.x). A 3.x pre-filter is applied to functions of a query, filtering for a specific set of events.
  • Creating a 2.x group as a 3.x split-byIn 3.x, Split by provides similar functionality to that of Group in 2.x. When you Split by a property, you group events that match the specified parameters. This article shows you how to specify a 2.x Group and how to create a 3.x query that uses Split by with a property.
  • Creating a 2.x session using 3.x flowsThis article shows how to model a user session in Scuba 2.x and 3.x and run queries to count the number of sessions per week, find the longest session each week, and find out the largest number of a specific event within a session each week.
  • Measuring 2.x events with 3.x ShowThis article demonstrates how to recreate a 2.x Count Events measure in 3.x using Show Count of Events.
  • Using a 2.x Measure aggregate as a 3.x Show aggregateAn aggregate is a function where the values of multiple rows are grouped together as input on specified criteria to form a single value of more significant meaning or measurement. This article shows you how to specify a 2.x Measure aggregate for a query, then how to specify a 3.x Show function for a query.
  • Using a 2.x per-actor metric as a 3.x actor propertyPer-actor metrics in 2.x are very similar to Actor properties in 3.x. This article shows you how to create a per-actor metric in Scuba 2.x, and then an actor property in Scuba 3.x.


  • Was this article helpful?