Skip to main content
Skip table of contents

Building Blocks

This article introduces the conceptual building blocks and basic queries that provide a foundation for creating and analyzing queries in the Scuba UI.

Before you jump into using Scuba, familiarize yourself with the following:


An event is something that happens at a specific time. In Scuba, an event consists of an actor, an action, and the time that the action occurred.

You can associate properties with events, depending on the type of action. Properties can act as filters or perform functions, depending on the purpose of the query. Scuba has pre-configured event properties you can use, or you can create your own custom properties. Creating a property is similar to creating a formula-based column in Excel. For more information, see Create an event property.

You can create aggregations of events, choosing the event property you want to aggregate, and then the operator. This is similar to how you'd create a formula-base summary row in Excel. You can create event aggregations directly as a query in the Explorer, or as part of a custom actor property or custom flow property.


An actor is the person, utility, or bot that generates an event. Scuba stores events separately for each actor. This means you can construct queries that perform simple aggregations of event properties for each actor, much like  a pivot table in Excel. Such as, a pivot table that calculates a few sums, plus a maximum, over all the events, then groups those results by user. These aggregations are defined as a custom actor property.

In addition to custom actor properties that do aggregations of events, you can build custom actor properties that run a formula against other custom actor properties for the same actor. For more information, see Create an actor property.


A flow is a visual representation of a path of actions an actor takes, an intuitive graph plotting the actor's journey. You can view the paths of all actors simultaneously, and then take a sequence of events by a particular actor to analyze with finer granularity.

Among their many uses, flows provide the ability to analyze actor engagement, conversion, and path discovery. For more information, see Create a flow and Create a flow property.


When you construct a query, you specify the time over which the query scans for results by choosing from intuitive intervals or entering custom values. You can specify non-uniform intervals, such as month and calendar quarter, as well as uniform intervals such as seconds, minutes, hours, days, and years. You can select either exact dates or relative time. For more information, see Specify time in a query.

Basic queries

The following are examples of queries that provide information important to most businesses. You can create these queries while getting oriented with Scuba without having to build custom objects. For step-by-step instructions for creating these queries, see Build queries and visualizations in the User's Guide.

Show count of events

See Show a count of events for more information.

Show count of actors

See Show a count of actors for more information.

Show count unique split by action
Show count unique split by two categories

What's Next

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.