# uip insights

> `uip insights` queries **UiPath Insights** — the analytics layer over job execution data. The tool exposes the preset Insights dashboards as commands: overall summary, completed- and uncompleted-job timelines, top failing processes, failure grouping by reason, and detailed per-process and per-failure drill-downs.

`uip insights` queries **UiPath Insights** — the analytics layer over job execution data. The tool exposes the preset Insights dashboards as commands: overall summary, completed- and uncompleted-job timelines, top failing processes, failure grouping by reason, and detailed per-process and per-failure drill-downs.

Install it with `uip tools install insights`, or invoke `uip insights …` and let auto-install run. The underlying package is `@uipath/insights-tool`; the command prefix is `insights`. See [Tools (plugins)](./concepts-tools.md) for the install model and [`uip tools`](./uip-tools.md) for the command that manages tool installation.

## Resources

| Resource | Purpose |
|---|---|
| [jobs](./uip-insights-jobs.md) | Summary, completed- and uncompleted-job timelines, top failures, failures by reason, per-process breakdowns, and failure-detail drill-downs. |

## Synopsis

```
uip insights jobs <verb> [options]
```

All `uip insights` verbs honor the [global options](./global-options.md) (`--output`, `--output-filter`, `--log-level`, `--log-file`) and the standard [exit codes](./exit-codes.md).

## Shared filters

Every `insights jobs` subcommand accepts the same filter surface — time range, folders, processes, machines. The flag set is documented inline on the [jobs](./uip-insights-jobs.md#shared-filters) page.

Use either `--time-range` *or* the absolute `--started-after`/`--started-before` pair. Combining them is valid but the Insights backend resolves to whichever interval is narrower. All filters are optional; an unfiltered query returns tenant-wide data for the default time range.

## Authentication

Every Insights call uses the session established by [`uip login`](./uip-login.md). If no session is present, the CLI emits `Failure` with `Instructions: "Run 'uip login' to authenticate first."` and exits `1`.

## See also

- [Tools (plugins)](./concepts-tools.md) — install, update, uninstall the `@uipath/insights-tool` package.
- [`uip login`](./uip-login.md) — session used for every Insights call.
- [`uip traces`](./uip-traces.md) — LLM Observability spans, an orthogonal observability surface.
- [Global options](./global-options.md)
- [Exit codes](./exit-codes.md)