Skip to main content

Dashboards

The Dashboards option allows a user to create dashboards using a catalog of dashboard components. Flowable Work ships with a set of out-of-the-box components, but custom ones can easily be created using customized query models and dashboard component models.

note

If dashboards aren't visible, they might need to be enabled by an administrator user. See the admin guide for more details.

Also note that dashboards are user-bound, i.e. the dashboards are unique to the logged in user.

The dashboard UI has two high-level UI parts: the Header with filters and the Component Canvas:

Dashboards Example

After creating a new dashboard, click the Edit dashboard button, which puts the canvas into edit-mode:

Dashboards Example

The button with the plus icon on the right-hand side can be used to add new components. The three dots can be clicked to show the filters or to delete the dashboard. The Save dashboard button on the left will save all current changes and switch back to the view-mode.

Clicking the button with the plus icon button opens the Component catalog, which lists every component available to you: the out-of-the-box components shipped with Flowable Work plus any custom components published to this system.

Components in the catalog are organised by category: Agent, Case, Process and Task. Select a category to browse its components, then pick one to add it to the dashboard. If any component is uncategorized, it will show up in Custom (and in the All category)

Component catalog

The categories are described in more detail in Out-of-the-box components below. Note that the Agent components are only visible to users with the access-agentData authority.

After choosing a component, a custom title and component-specific settings can be configured.

note

When multiple dashboard components reuse the same filter (for example the process definition picker), only one entry is rendered in the header. When the filter is changed, all components that use it will re-fetch the data and re-render.

Out-of-the-box components

The following out-of-the-box components ship with Flowable Work, grouped by the catalog categories. Most can be filtered by a time period (start/end) and by the relevant definition; when several components on the same dashboard share a filter, it is rendered only once in the header. The catalog contains additional variants (per-definition, per-model, per-date breakdowns) of many of them.

Agent

Components for monitoring AI agents. They require the access-agentData authority (a user without it will not see the Agent category) and read from indexed agent data, so agent data indexing must be enabled for them to show meaningful values. They can be filtered by agent definition and time period.

Agent components measure two runtime concepts: agent instances (individual runs of an agent definition) and agent invocations (the individual agent/LLM calls made within those runs).

Instances & invocations: how much agent activity is happening, and the state of agent runs.

ComponentShowsType
Agent invocationsTotal number of agent/LLM calls in the periodValue
Instances started / completedAgent runs started and completedValue
Instance stateDistribution of instances by statePie Chart
Invocations over timeInvocation volume per dayLine Chart

Token usage: consumption of prompt, output and cached tokens.

ComponentShowsType
Total tokensSum of all tokens usedValue
Average tokens per invocationMean token usage per callValue
Token type sharePrompt vs. output vs. cached splitPie Chart
Total tokens over timeToken consumption per dayLine Chart

Cost: estimated LLM cost, based on the configured per-model prices.

ComponentShowsType
Total agent costEstimated cost across all LLMsValue
Cost by LLMCost broken down per modelBar Chart
Cost over timeEstimated cost per dayLine Chart

Tools & latency: tool calls made by agents and how long they take.

ComponentShowsType
Total tool callsNumber of tool invocationsValue
Tools by nameMost/least used toolsBar / Pie Chart
Tool latency percentilesp50 / p95 / p99 tool durationBar Chart
Average tool durationMean tool execution timeValue

Guardrails: guardrail evaluations and violations.

ComponentShowsType
Guardrail violationsNumber of guardrail violationsValue
Guardrail pass rateShare of evaluations that passedPie Chart
Total guardrail evaluationsNumber of guardrail checksValue
Guardrails over timeViolations/evaluations per dayLine Chart

Case

Components for monitoring case instances, filterable by case definition and time period.

ComponentShowsType
Number of case instances startedTotal case instances started in the periodValue
Number of case instances completedTotal case instances completed in the periodValue
Distribution of case instances by definitionWhich case definitions account for the most instancesPie Chart
Case instance status breakdownThe active-vs-completed split at a glancePie Chart
Comparison of case instances by definitionCompare how many case instances ran for each definitionBar Chart
Comparison of case instances by states and definitionBreak down counts by state and definition to spot stuck casesBar Chart
Number of started case instancesCase instance creation volume over timeLine Chart
Number of completed case instancesCase instance completion volume over timeLine Chart
Number of started vs completed case instancesThroughput over time, comparing started vs completedLine Chart
Case instance information tableDrill into individual case instances with configurable, sortable columnsTable

Process

Components for monitoring process instances, filterable by process definition and time period.

ComponentShowsType
Number of process instances startedTotal process instances started in the periodValue
Number of process instances completedTotal process instances completed in the periodValue
Distribution of process instances by definitionWhich process definitions account for the most instancesPie Chart
Process instance status breakdownThe active-vs-completed split at a glancePie Chart
Comparison of process instances by definitionCompare how many process instances ran for each definitionBar Chart
Comparison of process instances by states and definitionBreak down counts by state and definition to spot stuck processesBar Chart
Number of started process instancesProcess instance creation volume over timeLine Chart
Number of completed process instancesProcess instance completion volume over timeLine Chart
Number of started vs completed process instancesThroughput over time, comparing started vs completedLine Chart
Process instance information tableDrill into individual process instances with configurable, sortable columnsTable

Task

Components for monitoring tasks, filterable by process/case definition and time period.

ComponentShowsType
Number of tasks createdTotal tasks created in the periodValue
Number of tasks completedTotal tasks completed in the periodValue
Distribution of tasks by process or case definitionWhich definitions generate the most tasksPie Chart
Task status breakdownThe active-vs-completed split at a glancePie Chart
Number of created tasksTask creation volume over timeLine Chart
Number of completed tasksTask completion volume over timeLine Chart
Number of created vs completed tasksThroughput over time, comparing created vs completedLine Chart
Task information tableDrill into individual tasks with configurable, sortable columnsTable