# Using the Analytics UI

Open the analytics UI at `/analytics` on the host where Event Monitoring is deployed.
For the Emerson example environment, the UI is available at [https://emerson.spiff.works/analytics](https://emerson.spiff.works/analytics).

The UI uses your SpiffArena 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:

1. Choose a key from the metadata selector.
2. Click **New Filter**.
3. Enter the value.
4. Choose the value type: `text`, `int`, or `float`.
5. Click **Add**.
6. 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.