--- title: "Query aggregated long tasks" method: POST path: "/api/v2/rum/query/insight/aggregated_long_tasks" tags: ["RUM Insights"] --- # Query aggregated long tasks `POST /api/v2/rum/query/insight/aggregated_long_tasks` Get aggregated long task data for a RUM view, grouped by invoker type and sampled across multiple view instances. ## Request body - AggregatedLongTasksRequest — Request body for the aggregated long tasks endpoint. - `data` AggregatedLongTasksRequestData, required — Data envelope for an aggregated long tasks request. - `attributes` AggregatedLongTasksRequestAttributes, required — Attributes for an aggregated long tasks query. - `application_id` string, required — The RUM application ID to analyze. - `criteria` AggregatedWaterfallPerformanceCriteria — Performance criteria to filter view instances by a metric threshold. - `max` number, double — Maximum threshold in seconds (inclusive). - `metric` 'loading_time' | 'largest_contentful_paint' | 'first_contentful_paint' | 'interaction_to_next_paint', required — Performance metric used to filter view instances by threshold. - `min` number, double — Minimum threshold in seconds (inclusive). - `filter` string — RUM query string to filter events (for example, @session.type:user @geo.country:US). - `from` integer, required — Start of the time range as a Unix timestamp in seconds. - `sample_size` integer, required — Number of view instances to sample, between 1 and 500. - `to` integer, required — End of the time range as a Unix timestamp in seconds. - `view_name` string, required — The RUM view name to analyze (for example, /account/login). - `type` 'aggregated_long_tasks', required — The JSON:API type for aggregated long tasks requests. ## Response `201` Successful response - AggregatedLongTasksResponse — Response body for the aggregated long tasks endpoint. - `data` AggregatedLongTasksResponseData, required — Data envelope for an aggregated long tasks response. - `attributes` AggregatedLongTasksResponseAttributes, required — Attributes of an aggregated long tasks response. - `application_id` string, required — The RUM application ID that was analyzed. - `criteria` AggregatedWaterfallPerformanceCriteria — Performance criteria to filter view instances by a metric threshold. - `max` number, double — Maximum threshold in seconds (inclusive). - `metric` 'loading_time' | 'largest_contentful_paint' | 'first_contentful_paint' | 'interaction_to_next_paint', required — Performance metric used to filter view instances by threshold. - `min` number, double — Minimum threshold in seconds (inclusive). - `from` integer, required — Start of the analyzed time range as a Unix timestamp in seconds. - `long_tasks_by_invoker_type` AggregatedLongTasksByInvokerType[], required — Long task statistics grouped by invoker type, sorted by impact score descending. - `criteria_view_occurrences` integer — Number of sampled views where this invoker type had long tasks contributing to the criteria metric. - `impact_score` number, double — Rank-product impact score combining view frequency and blocking time severity. - `invoker_type` string, required — Category of the long task invoker (for example, resolve-promise, user-callback). - `stats_per_view` LongTaskStatsPerView, required — Statistical distributions of long task metrics computed per view across sampled views. - `fcp_blocking_time_ms` LongTaskMetricStats — Statistical distribution (average, min, max) of a long task metric across sampled views. - `average` number, double, required — Average value across sampled views. - `max` number, double, required — Maximum value across sampled views. - `min` number, double, required — Minimum value across sampled views. - `fcp_count` LongTaskMetricStats — Statistical distribution (average, min, max) of a long task metric across sampled views. - `average` number, double, required — Average value across sampled views. - `max` number, double, required — Maximum value across sampled views. - `min` number, double, required — Minimum value across sampled views. - `inp_overlap_blocking_time_ms` LongTaskMetricStats — Statistical distribution (average, min, max) of a long task metric across sampled views. - `average` number, double, required — Average value across sampled views. - `max` number, double, required — Maximum value across sampled views. - `min` number, double, required — Minimum value across sampled views. - `inp_overlap_count` LongTaskMetricStats — Statistical distribution (average, min, max) of a long task metric across sampled views. - `average` number, double, required — Average value across sampled views. - `max` number, double, required — Maximum value across sampled views. - `min` number, double, required — Minimum value across sampled views. - `lcp_blocking_time_ms` LongTaskMetricStats — Statistical distribution (average, min, max) of a long task metric across sampled views. - `average` number, double, required — Average value across sampled views. - `max` number, double, required — Maximum value across sampled views. - `min` number, double, required — Minimum value across sampled views. - `lcp_count` LongTaskMetricStats — Statistical distribution (average, min, max) of a long task metric across sampled views. - `average` number, double, required — Average value across sampled views. - `max` number, double, required — Maximum value across sampled views. - `min` number, double, required — Minimum value across sampled views. - `loading_time_blocking_time_ms` LongTaskMetricStats — Statistical distribution (average, min, max) of a long task metric across sampled views. - `average` number, double, required — Average value across sampled views. - `max` number, double, required — Maximum value across sampled views. - `min` number, double, required — Minimum value across sampled views. - `loading_time_count` LongTaskMetricStats — Statistical distribution (average, min, max) of a long task metric across sampled views. - `average` number, double, required — Average value across sampled views. - `max` number, double, required — Maximum value across sampled views. - `min` number, double, required — Minimum value across sampled views. - `total_blocking_time_ms` LongTaskMetricStats — Statistical distribution (average, min, max) of a long task metric across sampled views. - `average` number, double, required — Average value across sampled views. - `max` number, double, required — Maximum value across sampled views. - `min` number, double, required — Minimum value across sampled views. - `total_count` LongTaskMetricStats — Statistical distribution (average, min, max) of a long task metric across sampled views. - `average` number, double, required — Average value across sampled views. - `max` number, double, required — Maximum value across sampled views. - `min` number, double, required — Minimum value across sampled views. - `top_invokers` TopLongTaskInvoker[], required — Top invokers within this invoker type, sorted by impact score descending. - `criteria_view_occurrences` integer — Number of sampled views where this invoker had long tasks contributing to the criteria metric. - `file` string, nullable, required — Cleaned source file path for the invoker script. - `impact_score` number, double — Rank-product impact score combining view frequency and blocking time severity. - `invoker` string, required — Name of the invoker function or script. - `stats_per_view` LongTaskStatsPerView, required — Statistical distributions of long task metrics computed per view across sampled views. - `fcp_blocking_time_ms` LongTaskMetricStats — Statistical distribution (average, min, max) of a long task metric across sampled views. - … - `fcp_count` LongTaskMetricStats — Statistical distribution (average, min, max) of a long task metric across sampled views. - … - `inp_overlap_blocking_time_ms` LongTaskMetricStats — Statistical distribution (average, min, max) of a long task metric across sampled views. - … - `inp_overlap_count` LongTaskMetricStats — Statistical distribution (average, min, max) of a long task metric across sampled views. - … - `lcp_blocking_time_ms` LongTaskMetricStats — Statistical distribution (average, min, max) of a long task metric across sampled views. - … - `lcp_count` LongTaskMetricStats — Statistical distribution (average, min, max) of a long task metric across sampled views. - … - `loading_time_blocking_time_ms` LongTaskMetricStats — Statistical distribution (average, min, max) of a long task metric across sampled views. - … - `loading_time_count` LongTaskMetricStats — Statistical distribution (average, min, max) of a long task metric across sampled views. - … - `total_blocking_time_ms` LongTaskMetricStats — Statistical distribution (average, min, max) of a long task metric across sampled views. - … - `total_count` LongTaskMetricStats — Statistical distribution (average, min, max) of a long task metric across sampled views. - … - `view_occurrences` integer, required — Number of sampled views where this invoker had any long tasks. - `view_occurrences` integer, required — Number of sampled views where this invoker type had any long tasks. - `sampled_view_ids` string[], required — List of RUM view IDs sampled for this aggregation, capped at 50. - `to` integer, required — End of the analyzed time range as a Unix timestamp in seconds. - `view_count` integer, required — Number of view instances included in the analysis. - `view_name` string, required — The RUM view name that was analyzed. - `id` string, required — Hash-based unique identifier for this aggregation. - `type` 'aggregated_long_tasks', required — The JSON:API type for aggregated long tasks requests. ## Other responses - `400` — Bad Request - `401` — Unauthorized - `429` — Too many requests --- [API](https://skmtc.dev/datadog/apis/api-v2.md) · [All operations](https://skmtc.dev/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)