- Introduction
- Getting started
- Process modeling
- Process implementation
- Debugging
- Simulating
- Publishing and upgrading agentic processes
- Common implementation scenarios
- Extracting and validating documents
- Process operations
- Process monitoring
- Understanding Process monitoring
- Instance diagram view
- Creating a custom Maestro dashboard in Insights
- Alerts
- Notifications
- Process optimization
- Reference information
Maestro user guide
UiPath Maestro integrates seamlessly with UiPath Insights, allowing you to monitor and troubleshoot orchestrated processes in real time. While the default Maestro templates provide a prebuilt overview, you can also create custom dashboards tailored to your KPIs, business rules, or operational goals.
Start from the Maestro template
To customize the default Maestro dashboard, copy or download the Maestro template from the Insights portal.
-
Open the UiPath Insights portal.
-
Go to the Templates tab and search for Maestro.
-
Select the Maestro template and choose Copy or Download to begin customizing it.
Result: The template is copied and ready for customization in Insights.
This template includes key Maestro metrics such as:
-
Process status counts
-
Error types
-
Process durations
Build a custom dashboard from scratch
To create a dashboard tailored to your needs:
-
In Insights, select Create New Dashboard and choose Custom Dashboard.
-
Use the drag-and-drop panel to add widgets like:
- KPI tiles (e.g., Processes in Progress)
- Bar charts (e.g., Top Processes Executed)
- Tables (e.g., Top Failed Elements)
Result: The custom dashboard is created with your selected widgets and Maestro data sources.
You can pull data from prebuilt Maestro datasets such as:
-
Agentic process executions
-
Element-level failures
-
Average duration per process or tenant
-
Real-time fault trends
Filter and scope the data
Apply filters to narrow the data for your use case:
- Status: Running, Completed, Faulted, Cancelled
- Event time: Last 7 days, This month, etc.
- Folder or Process name
Filters can be applied globally or per widget, making dashboards reusable across teams or tenants.
Maestro sends a new record to Insights for each status change of a process/element (for example: InProgress, Completed, Faulted, Cancelled). This append‑only design means you may see multiple rows for the same run. When building widgets that should show one row per run (e.g., final durations), add a filter such as Status = Completed (or otherwise restrict to the latest status per instance).
Monitor and share
To keep your dashboard current and accessible, configure automatic refresh and role-based sharing.
-
Set up automatic refresh intervals (e.g., every 30 minutes).
-
Share dashboards with role- or tenant-based access.
-
Pin frequently used dashboards to your Insights homepage.
Result: The dashboard refreshes automatically and is shared with the configured access.
To learn more, see Best practices for dashboard customizations.