Path Metrics

Path metrics are scalar values computed per path (user journey). They are used in three places:

Segment Overview — metrics are aggregated per segment and displayed as a heatmap.
Cluster Analysis — metrics are used as features for clustering, and separately as overview metrics for the resulting clusters.
Filter Paths — metrics are used as conditions to keep or drop entire paths.

Available metrics

Metric	Description	metric_args
`length`	Total number of events in the path.	—
`duration`	Time in seconds between the first and last event.	—
`active_days`	Number of distinct calendar days with at least one event. Optionally restricted to specific events.	`active_events`: list[str] (optional)
`event_count`	Number of times the specified event(s) occurred.	`event`: str or list[str]
`has`	1 if the specified event(s) occurred at least once, 0 otherwise.	`events`: str or list[str]
`time_between`	Time in seconds between the first occurrences of two events. Returns null if either event is missing. Use `path_start` or `path_end` as anchors.	`event_from`: str `event_to`: str
`first_event_dt`	Unix timestamp of the first event in the path.	—
`matches`	1 if the path matches a sequence pattern, 0 otherwise. Events are separated by `->` and `.` matches any sequence. Example: `login->.->purchase`.	`pattern`: str
`belongs_to`	Checks whether path events belong to a segment value. Mode `any`: at least one event has the value. `all`: all events have the value. `event_share`: at least a threshold share of events have the value. If multiple segment values are selected, a separate metric is created for each value.	`segment_name`: str `segment_value`: str or list[str] `mode`: `"any"` \| `"all"` \| `"event_share"` `threshold`: float (for `event_share`)

Metric config format

Metrics appear in two different config formats depending on where they are used:

Segment Overview (metrics_config) and Cluster Analysis (metrics_config) — each metric requires an agg field that defines how per-path values are aggregated across paths in a segment.
Cluster Analysis (features) — no agg field. The raw per-path values are used directly as clustering features.
Filter Paths — metrics appear inside a condition tree with comparison operators. See the Filter Paths condition format section below.

Key	Required	Description
`metric`	yes	Metric name from the table above.
`metric_args`	depends	Additional arguments for the metric. Required for `event_count`, `has`, `time_between`, `matches`, and `belongs_to`.
`agg`	yes (Segment Overview and Cluster Analysis `metrics_config` only)	Aggregation function. See aggregations below.

metrics_config=[
    {"metric": "length", "agg": "mean"},
    {"metric": "duration", "agg": "median"},
    {"metric": "event_count", "metric_args": {"event": "purchase"}, "agg": "mean"},
    {"metric": "has", "metric_args": {"events": ["add_to_cart", "purchase"]}, "agg": "mean"},
    {"metric": "time_between", "metric_args": {"event_from": "path_start", "event_to": "purchase"}, "agg": "median"},
    {"metric": "matches", "metric_args": {"pattern": "login->.*->purchase"}, "agg": "mean"},
]

Aggregations

Aggregations apply to metrics_config in Segment Overview and Cluster Analysis. They are not used for clustering features or in Filter Paths conditions.

Value	Description
`mean`	Mean value across all paths in the segment.
`median`	Median value (50th percentile).
`q5`	5th percentile.
`q25`	25th percentile.
`q75`	75th percentile.
`q95`	95th percentile.
`complement_diff`	Wasserstein distance between this segment's distribution and all other segments combined. Higher means more distinctive from the rest. Segment Overview only — requires a segment column to define what "the rest" means.

Filter Paths condition format

In Filter Paths, metrics are used inside a condition tree rather than a flat list. Each leaf node specifies a metric, a comparison operator, and a value:

# Single condition
{"op": ">", "metric": "length", "value": 5}

# Combine conditions
{
    "op": "and",
    "args": [
        {"op": ">", "metric": "length", "value": 3},
        {"op": "=", "metric": "has", "metric_args": {"events": "purchase"}, "value": True},
    ]
}

Supported operators: =, !=, >, <, >=, <=, in. Logical nodes use and, or, not with an args list.