--- 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` ## Request - Base URL: `https://api.datadoghq.com` - URL: `https://api.datadoghq.com/api/v2/rum/query/insight/aggregated_long_tasks` - Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY` 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/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)