- Overview
- Get started
- Concepts
- Using UiPath CLI
- How-to guides
- CI/CD recipes
- Command reference
- Overview
- Exit codes
- Global options
- uip codedagent
- uip coder
- uip context-grounding
- uip docsai
- uip function
- uip guardrails
- uip llm-configuration
- uip llm-gateway
- uip maestro authoring
- uip maestro registry
- uip model-hub
- activities find
- activities get-default-xaml
- analyze
- analyzer-rules list
- build
- cleanup
- data-fabric-entities install
- data-fabric-entities list
- files diff
- get-library-object-repository
- get-object-repository
- init
- instances list
- pack
- packages inspect
- packages install
- packages versions
- publish
- remote
- restore
- run, debug & execution
- settings
- studio start
- templates search
- test-data add-entity
- test-data add-queue
- test-data add-variation
- tm
- uia
- validate
- workflow-examples get
- workflow-examples list
- uip tasks
- uip traces
- uip traces feedback
- Migration
- Reference & support
uip insights queues
Syntax and options for `uip insights queues`, which queries Insights queue monitoring data such as item counts, SLA buckets, timelines, failures, and retry outcomes.
uip insights queues queries UiPath Insights queue monitoring data for a time window: queue item totals, SLA buckets, per-bucket timelines, failure rankings and drill-downs, per-queue details, and retry outcomes.
Synopsis
uip insights queues summary <time range> [filters]
uip insights queues sla <time range> [filters] [-l <n>] [-o <n>]
uip insights queues operational-metrics <time range> [filters] --widget-type <rda|non-rda> [-l <n>] [-o <n>]
uip insights queues completed-timeline <time range> [filters] [--time-event <event>] [--timezone-offset <minutes>] [-l <n>] [-o <n>]
uip insights queues uncompleted-timeline <time range> [filters] [--time-event <event>] [--timezone-offset <minutes>] [-l <n>] [-o <n>]
uip insights queues top-failures <time range> [filters] [-l <n>] [-o <n>]
uip insights queues failures-by-reason <time range> [filters] [--group-by <queue|robot>...] [-l <n>] [-o <n>]
uip insights queues failure-details <time range> [filters] (--error-message <message> | --null-error-message) [--robot-name <name>] [-l <n>] [-o <n>]
uip insights queues details <time range> [filters] [-l <n>] [-o <n>]
uip insights queues retry-outcomes <time range> [filters] [-l <n>] [-o <n>]
uip insights queues summary <time range> [filters]
uip insights queues sla <time range> [filters] [-l <n>] [-o <n>]
uip insights queues operational-metrics <time range> [filters] --widget-type <rda|non-rda> [-l <n>] [-o <n>]
uip insights queues completed-timeline <time range> [filters] [--time-event <event>] [--timezone-offset <minutes>] [-l <n>] [-o <n>]
uip insights queues uncompleted-timeline <time range> [filters] [--time-event <event>] [--timezone-offset <minutes>] [-l <n>] [-o <n>]
uip insights queues top-failures <time range> [filters] [-l <n>] [-o <n>]
uip insights queues failures-by-reason <time range> [filters] [--group-by <queue|robot>...] [-l <n>] [-o <n>]
uip insights queues failure-details <time range> [filters] (--error-message <message> | --null-error-message) [--robot-name <name>] [-l <n>] [-o <n>]
uip insights queues details <time range> [filters] [-l <n>] [-o <n>]
uip insights queues retry-outcomes <time range> [filters] [-l <n>] [-o <n>]
These commands honor the global options and the standard exit codes. They use the tenant selected during uip login.
Shared options
A time range is required: pass --time-range, or both --started-after and --started-before.
| Flag | Description |
|---|---|
--time-range <minutes> | Relative window in minutes, ending now, for example 1440 for the last day. The server caps it at 30 days. |
--started-after <epoch-ms> | Absolute window start, as Unix epoch milliseconds. Requires --started-before. |
--started-before <epoch-ms> | Absolute window end, as Unix epoch milliseconds. Requires --started-after. |
--folder-key <guids...> | Restrict to these folder keys. Defaults to every folder the caller can access. |
--queue-name <names...> | Restrict to these queue names. Discover them with uip insights filter-queues list. |
-l, --limit <number> | Maximum rows to return. Defaults to 50. Not on summary. |
-o, --offset <number> | Rows to skip before returning results. Not on summary. |
uip insights queues summary
Get total and successful queue item counts and the average processing time for a window.
uip insights queues summary --time-range 1440
uip insights queues summary --time-range 1440
The command returns Code: "InsightsQueuesSummary" and Data with SuccessfulQueueItems, TotalQueueItems, and AverageProcessingTimeMs.
uip insights queues sla
List SLA bucket counts, first breach times, and robot demand: one row per queue name, with one representative process. A server error here can mean that a queue has new items but no completed items with timings, which retrying does not clear.
uip insights queues sla --time-range 1440 --queue-name InvoiceProcessing
uip insights queues sla --time-range 1440 --queue-name InvoiceProcessing
The command returns Code: "InsightsQueuesSla". Each row has these fields:
| Field | Description |
|---|---|
QueueName, ProcessName | The queue and its representative process. |
InSlaCount, AtRiskCount, OutOfSlaCount | Item counts per SLA bucket. |
FirstSlaBreachAt, FirstRiskBreachAt | First SLA breach and first risk breach times. |
AverageHandlingTimeMs, AveragePendingTimeMs | Average handling and pending times, in milliseconds. |
RunningRobots, NecessaryRobots | Robots running and robots needed. |
uip insights queues operational-metrics
List the Dedicated SaaS operations table: per-day loaded, completed, exception, and reconcile counts. --widget-type is required and selects the query: non-rda reports per queue, rda per RDA process.
uip insights queues operational-metrics --time-range 10080 --widget-type non-rda
uip insights queues operational-metrics --time-range 10080 --widget-type non-rda
The command returns Code: "InsightsQueuesOperationalMetrics". Each row has TenantName, RunDate, AirId, QueueName, OpeningBalance, Loaded, Completed, SystemException, BusinessException, Abandoned, Pending, Reconcile, and SuccessPercentage.
uip insights queues completed-timeline and uncompleted-timeline
List queue item counts per time bucket. completed-timeline reports failed, successful, abandoned, and deleted items. uncompleted-timeline reports new, in-progress, and retried items.
| Flag | Description |
|---|---|
--time-event <event> | Queue item timestamp the buckets are built from. latest (default), creation, start, or end. uncompleted-timeline does not offer end. |
--timezone-offset <minutes> | Shift the reported StartTime and EndTime by this many minutes, in the JavaScript getTimezoneOffset convention: pass -120 to label buckets in UTC+2. Bucket boundaries stay aligned to UTC. |
uip insights queues completed-timeline --time-range 1440 --time-event end
uip insights queues completed-timeline --time-range 1440 --time-event end
completed-timeline returns Code: "InsightsQueuesCompletedTimeline", with rows of StartTime, EndTime, Failed, Successful, Abandoned, and Deleted. uncompleted-timeline returns Code: "InsightsQueuesUncompletedTimeline", with rows of StartTime, EndTime, New, InProgress, and Retried.
uip insights queues top-failures
List the queues with the most failed items, with application and business exception counts.
uip insights queues top-failures --time-range 10080
uip insights queues top-failures --time-range 10080
The command returns Code: "InsightsQueuesTopFailures". Each row has QueueName, ApplicationExceptions, BusinessExceptions, and ClassifiedFailures.
uip insights queues failures-by-reason
List queue item failure counts grouped by exception reason and type.
| Flag | Description |
|---|---|
--group-by <dimensions...> | Split each row by queue or robot, adding a QueueName or RobotName column. |
uip insights queues failures-by-reason --time-range 10080 --group-by queue
uip insights queues failures-by-reason --time-range 10080 --group-by queue
The command returns Code: "InsightsQueuesFailuresByReason". Each row has ExceptionReason, ExceptionType, and Count, plus QueueName or RobotName with --group-by. A row can carry a null ExceptionReason.
uip insights queues failure-details
List the individual queue items that failed with one exception reason. Pass exactly one of --error-message and --null-error-message.
| Flag | Description |
|---|---|
--error-message <message> | Exact exception reason, taken verbatim from failures-by-reason. |
--null-error-message | Drill into the failures with no exception reason: the failures-by-reason row with a null ExceptionReason. |
--robot-name <name> | Select items this robot failed at least once. The returned rows are not themselves filtered by robot. |
uip insights queues failure-details --time-range 10080 --error-message "Invoice total mismatch"
uip insights queues failure-details --time-range 10080 --error-message "Invoice total mismatch"
The command returns Code: "InsightsQueuesFailureDetails". Each row has QueueName, QueueId, QueueItemId, QueueItemKey, FolderId, CreatedAt, StartedAt, EndedAt, and DurationMs.
uip insights queues details
List queue item counts per queue and folder, with duration aggregates.
uip insights queues details --time-range 1440
uip insights queues details --time-range 1440
The command returns Code: "InsightsQueuesDetails". Each row has QueueName, FolderName, Successful, FailedBusiness, FailedApplication, Deleted, Abandoned, New, InProgress, Retried, AverageDurationMs, MedianDurationMs, and PercentileDurationMs.
uip insights queues retry-outcomes
List retried queue item counts per queue, and how many of those items later succeeded.
uip insights queues retry-outcomes --time-range 10080
uip insights queues retry-outcomes --time-range 10080
The command returns Code: "InsightsQueuesRetryOutcomes". Each row has QueueName, RetriedItems, SuccessfulItems, and SuccessRatePercent.
Related
uip insights filter-queueslists queue names with recent activity.uip insightsfor the tool overview.
- Synopsis
- Shared options
- uip insights queues summary
- uip insights queues sla
- uip insights queues operational-metrics
- uip insights queues completed-timeline and uncompleted-timeline
- uip insights queues top-failures
- uip insights queues failures-by-reason
- uip insights queues failure-details
- uip insights queues details
- uip insights queues retry-outcomes
- Related