Workflow Messages

First published on: 05/13/2025/3:02 pm

Messages generated by workflows can be viewed on the Messages page.

Three versions of this page allow you to view messages at the tenant, project, and workflow levels.

The tenant-level version of the messages page is available at https://app.saltbox.io/messages.

Project-level and workflow-level versions are available within each project and workflow menu. 

This page was updated with new functionality in May 2025. Changes specific to this update are highlighted in the New Functionality section below.

Feature Highlights

• Data visualizations
• Advanced filtering
• Grouped data
• Many messages are loaded at once
• Message actions menu

Data Visualizations

Data visualizations are displayed at the top of the page.

The visualizations summarize the data displayed on the data grid.

Above the data table is a condensed summary, which you can expand using the "More Details" button. 

The condensed summary looks like:

The expanded details look like: 

Widgets

Insights widgets display a summary of the filters applied to the data table below the insights section.

Insights filters don't apply to the data—they only refine the widget while on the current page.

If the page is refreshed, or the data filters are reset, the insight widget filters will also be reset.

Overall message status summary: count and percentage of messages per status.

Failed messages per project (when viewing the tenant-level data) or per workflow (when viewing the project-level data).

Summary of common error codes/categories: Expand the error code to see a detailed breakdown of error messages.

Users can use the filter button on the right hand of each code to filter the messages grid based on the selected code.

Summary of message counts, per type.

Advanced Filtering

Apply advanced filtering, such as date ranges or text search.

These filters will be applied to the messages listed in the data table and the visualizations.

By default, the "Created Date" filter is set to the last 24 hours. 

The environment is filtered automatically using your selected environment at the top of the page.

To see another environment's data, switch to that environment on the page level.

Grouped Data

Data is grouped by default so that the most important information is front and center.

At the tenant level, data is grouped by project, workflow, and status. 

At the project level, data is grouped by workflow and status. 

At the workflow level, data is grouped by status.

Expand data groups to see individual messages.

For example, in the screenshot below, the Lorem Ipsum project's groups are expanded, while the other projects display only status, not individual messages: 

Many Messages are Loaded at Once

When viewing messages, the page initially loads the last 24 hours of data.

Up to 30,000 messages are loaded at a time using filters, beyond which no additional insights or data are shown.

For tenants who have large volumes of messages, use filters to refine your data set into smaller sizes so you can gain insights.

Message Actions Menu

When message groups are expanded to display message-level details, an actions menu is displayed on the left.

A message group is expanded (marker 1 below), which displays the actions menu (markers 2a-2c below) for all messages contained within that group, and a message group is collapsed (marker 3 below), which doesn't show an actions menu (markers 4a-4e below).

Message actions include: 

• View Trigger Details—See the related trigger details for all message types.
  • For example, a "Raw Data"-type message was triggered by a trigger message, so on the "Raw Data"-type messages, you can see the parent trigger details.
• View Raw Details—View related raw data details for "Raw Data"- and "Message"-type messages.
• View Message Details—View details about "Message"-type messages (i.e., messages that can run through the main workflow logic).
  • This includes the body of the message's data. 
• Retry Message—Messages that have failed may be queued for retry.
  • Messages that have already succeeded or haven't run will not be able to execute this action.
• Go To Workflow Design—All messages display this option, which will open the workflow designer associated with this message.
• Go To Message Trace—View the message trace for Messages that have run through the main workflow logic.

New Functionality

The messages page was updated in May 2025 with several important quality-of-life features.

Key differences between the old version and the new version are highlighted below.

For a full set of feature highlights, see above.

Note that all existing functionality was transferred and is still available using the actions drop-down on the message level.

This feature adds data visualizations to the messages page.

This page replaces the existing messages screen in all its instances: tenant, project, and workflow levels.

By default, the visualizations take up as little space as possible, with an option to expand details if desired.

Initial Load

• Message insights are collapsed.
• Messages are grouped by default by project, workflow and status and groups are collapsed.
• Created Date filter is set to 24 hours.
• All filtered messages (up to the first 30,000) are displayed in the data grid. Previously, this page only loaded 200 messages at a time. This larger number provides a robust data set for insight widgets.
• Messages are filtered by the Environment selected on the global environment picker.

Functions

Users can:

• Remove/modify groupings as desired.
• Expand/collapse visible messages using groups.
• Minimize or maximize the visualization widgets using More Details/Hide Details button.
• Change the filtering on each column
  • Note that the Date option “Show All” is only available once additional filters are applied (status, message format etc.).
• Use the global search option to find specific messages.
• Use the "Update Status" option to update selected messages.

Message Insights

A "data summary" pane displays minified versions of insight charts in the available vertical space. Any charts that would overflow this vertical space is hidden.

A "data detail" pane display full scale versions of insight charts with the appropriate keys and filter options for each chart. Charts provide insights into the tabular data, such as "percent of messages in each state", "top error messages", "min/max/average message execution duration", etc.

Minified view:

Maximized view:

A breakdown of each widget type is found in the section Widgets above.

Previous