Often it is desired to get a quick overview of the business performance by monitoring the underlying processes. To achieve that, you can define reports in Camunda Optimize according to your KPIs (Key Performance Indicators) relevant to your business objectives. A dashboard shows multiple report so you can get an up-to-date view of the productivity of your system at one glance.

The dashboard itself consists of the edit mode and the view mode:

Edit Mode

The edit mode allows you to configure the dashboard and adjust it to your needs. Therefore, you can perform all kinds of changing operations such as

  • rename your dashboard
  • add/remove a report
  • save the current state with your applied changes
  • cancel changes you already applied to the dashboard
  • set filters that are available on the dashboard

Once you have prepared all your reports, you can now start to assemble them into a dashboard. Above the dashboard grid there is a Add a report button. Clicking on it, opens a modal, where you can select one of your defined reports and add it to the dashboard:

Please note that if the dashboard is inside a collection, only reports that are in the same collection can be added. If the dashboard is not in a collection, it can only contain reports that are also not in a collection.

In the Add Report modal, you can click on the “Add External Source” link to enter the URL of an external data source which should be added to the dashboard. This allows you to create dashboards that combine Optimize reports with data from other services. Such external reports are added as iframes to the dashboard.

You can drag the handle on the lower right corner of each report to resize it. To move the report to your desired place, you can simply drag it in any direction. As soon as you release the dragged report, it snaps to the closest grid position. Finally, you can delete the report from your dashboard by clicking on the x button on the upper right corner of each report.

Specifying Available Dashboard Filters

In the dashboard edit mode, there is a Filters button. Clicking that button shows a filters panel that allows specifying filters which will become available in the dashboard view mode. Adding a filter in the edit mode only makes it available in the view mode; the filter is not applied in the edit mode! There are four options for filters:

  • Start Date: Allows filtering by process instance start date
  • End Date: Allows filtering by process instance end date
  • Instance State: Allows filtering by process instance state, such as running, completed, or canceled
  • Variable: Allows filtering by process instance variable value

For variable filters, you need to specify which variable the filter should apply to. For String and Number variables, you also need to provide a list of values which should be allowed to be filtered by. In contrast to Report filters, adding a value in the modal will not immediately filter by this value, it will only make this value available to filter by in the dashboard view mode.

The list of variable names and values is compiled from all reports that are on the dashboard.

View Mode

Once you have defined how your dashboard should look like, the view mode provides you with all the features to monitor you process, such as:

  • fullscreen: display the dashboard in fullscreen and only see the essential information of your dashboard - the reports - and hide the header, control panel and footer. While in fullscreen mode, you can click on the Toggle Theme button to switch between the default light theme and a dark theme.
  • auto-refresh: this feature periodically updates the dashboard with the latest data. You can decide how often the update should be performed by setting a time span reaching from 1 to 60 minutes. An animation indicates when the next update is occurring. If you do not wish to use that feature anymore, you can disable it anytime. Note: when refreshing the dashboard page manually or switching to another page in between, the auto-refresh must be enabled again.

In case you want to share the dashboard with other people or want to embed it in a webpage, you can use the sharing feature of the dashboard. Just click on the share button, which opens up a pop over. You can enable the sharing by pressing the switch. Now, you can send the link to people who do not have access to Camunda Optimize and thus enable them to see the dashboard. Also you can use the provided code in the embed section of the sharing pop over and paste it into your webpage. Everyone that views the webpage can then see content of the dashboard. The shared versions of the dashboard allow only to view the dashboard itself. There is no possibility to alter it or perform other actions that might abuse Optimize. You can revoke the sharing anytime by disabling the share switch.

On top of that your are able to switch to the edit mode by clicking on the edit button or delete the whole dashboard, if you do not have any use for it anymore. If you want to see some more details about the report on the dashboard, you can interact with the reports. The kind of interaction always depends on the report itself.

If the interactions do not suffice to get the desired information or you want to edit the report, you can directly go to it by clicking on the report title.

Applying Dashboard Filters

In the dashboard view mode, there is a Filters button. Clicking that button opens a panel that shows all filters that are available for this dashboard. More filters can be made available in the dashboard edit mode.

Filters apply to all reports on the dashboard. If a report already has filters set, they will be be combined with the dashboard filter. E.g. if a report has a filter to only show running instances and a dashboard filter for suspended instances is set, the report will only show instances that are both running and suspended.

Variable Filters are only applied to reports whose process definition includes the variable. Otherwise the filter is ignored for that report. Other dashboard filters as well as filters defined directly on the report are still applied.