Profiles

Merge profile stacks into a call tree

Aggregates matching profile samples by stack and returns a call tree suitable for Flame Graph, Call Tree, and Top Table views. profile_type and profile_unit are required.

post/api/{org_id}/{stream_name}/profiles/merge

Request

Path parameters

org_idstring required

Organization name

stream_namestring required

Profiles stream name

Request body

data_sourcestring nullable
end_timeinteger
group_bystring nullable

Label column that splits series into groups (series endpoint only).

group_limitinteger nullable

Groups returned before the rest fold into one others group: 1..=50, default 10.

max_nodesinteger nullable
profile_typestring nullable
profile_unitstring nullable
service_namestring nullable
start_timeinteger

Missing reads as 0 so parse_required_time_range reports it, not the JSON parser.

stepstring nullable
timeoutinteger nullable

Response

Success

merged_totalinteger required

Sample weight represented in root / top after the unique-stack cap.

profile_typestring required
rootobject required

Call tree root (name / self / total / children).

tookinteger required
topobject[] required

Flattened top functions by exclusive (self) value (pre-truncation).

totalinteger required

Full sample weight in scope (from sum(value) when stacks were capped).

tree_truncatedboolean required

True when the call tree was cut to max_nodes and light nodes folded into other.

truncatedboolean required

True when unique stacks exceeded the query size limit.

unitstring required

Changes

No recorded changes to this operation across all 1 revision of this API.