Using the Analytics UI¶

Open the analytics UI at /analytics on the host where Analytics is deployed.

The UI uses your Spiff Arena authentication. If your session is not active, you will be redirected to log in before analytics data is shown.

Model Navigation¶

The left side of the page lists process groups and process models.

Select All Models to see aggregate activity across every model.
Open a process group to focus on that group and its child models.
Select a process model to review model-specific trends, durations, task activity, milestone activity, and errors.
Use Search Models when the model list is long.

Group and model pages keep their own filter settings in the browser, so returning to a model preserves the last date range, selected tab, metadata filters, diagram settings, and color thresholds used for that model.

Date and Metadata Filters¶

Use the date controls to set the reporting window. The start date is inclusive. The end date includes activity through the end of the selected day.

Process models can also expose metadata keys. When metadata keys are available:

Choose a key from the metadata selector.
Click New Filter.
Enter the value.
Choose the value type: text, int, or float.
Click Add.
Click Update to refresh the view.

Metadata filters are useful for narrowing analytics to a customer, division, region, priority, or other process-specific value extracted from running instances.

Views¶

The main analytics area has four views.

Overview¶

The Overview view summarizes active, completed, and errored work for the selected group or model.

For All Models or a process group, Overview also shows a sortable process model table. Use it to identify models with the most active, completed, or errored instances, then select a model for deeper analysis.

Active¶

The Active view focuses on process instances still in progress.

For groups, it shows active-instance totals, usage trends, and longest-running models. For individual models, it also shows the BPMN diagram with task activity overlays and duration coloring.

Complete¶

The Complete view focuses on finished process instances.

For groups, it shows completion counts, change in duration, usage trends, duration trends, most frequently used models, and longest-running models. For individual models, it adds model-specific duration distributions, task overlays, and milestone summaries.

Errors¶

The Errors view focuses on process instances or tasks that ended with errors.

For groups, it summarizes errors by model. For individual models, it shows error counts and error detail by BPMN task.

Diagram Analysis¶

When a process model is selected, the UI can show the BPMN diagram for the model. The diagram is most useful in the Active and Complete views.

Use the diagram controls to switch between:

Tasks: overlays task counts and colors tasks by duration.
Milestones: overlays named milestone events and colors milestone timing.

For subprocesses and call activities, choose whether subprocess color should represent:

Longest Task: highlights the slowest task inside the subprocess.
Total Time: colors the subprocess by its total elapsed time.

Click a task or milestone overlay to open a duration distribution chart for that element. When a diagram includes call activities, drilldown controls let you inspect called models and use breadcrumbs to return to the parent diagram.

Thresholds and Color Schemes¶

Click Select thresholds to configure duration color bands. Thresholds can be entered in seconds, minutes, hours, days, or weeks.

Use thresholds to make the diagram reflect your operational expectations. For example, a task that is slow after four hours should use different thresholds than a task that is slow after several days.

Two color schemes are available:

Rainbow for broad duration bands.
Red-Green for a simpler good-to-bad scale.

Exporting Data¶

Click Export data to download a zip file for the selected group or model. The export includes CSV files for instances and tasks using the current date and metadata filters.

Use exports when you need offline analysis, auditing, or ad hoc reporting outside the browser.