Skip to main content
Skip table of contents


A whale is an actor that creates a disproportionate number of events in relation to the other actors. A whale actor can be any of the following:

  • Real actor—users who are an order of magnitude more active than most

  • System actor—services, notifications, and other automated events

  • Bot—a utility that automatically generates events

The imbalance that a whale creates can cause sampling errors, especially if the whale happens to be picked as a sampling shard. For unsampled queries, the whale shard impedes performance. If the whale continues to expand unchecked, the node runs out of disk space much faster than the other nodes in the cluster.

Scuba dissipates the data of actors who are detected to be whales across all the other shards on the node. In effect, this splashes the actors across the other shards on the node. The act of splashing balances the distribution of data to ensure efficient sampling.

Related terms

More information


JavaScript errors detected

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

If this problem persists, please contact our support.