Getting Started
Architecture
NServiceBus
Transports
Persistence
ServiceInsight
ServiceControl
Monitoring
Samples

Deleted Message Management

Component: ServicePulse

About deleting messages

Archiving can be useful for failed messages that no longer have business value. Once a message is deleted it can be automatically cleaned up according to the configuration of the retention policy.

Archiving in ServicePulse means that the failed messages are marked as Deleted. Data from a deleted message is still available, but it is no longer displayed in the Failed Messages list in ServicePulse, is not counted by the Failed Messages indicator in the ServicePulse dashboard, nor will it appear in any failed message groups.

Deleting messages

Deleted messages can be found in ServicePulse in a tab on the Failed Messages page. From the Failed Messages page, messages can also be deleted from:

  • the Failed Groups tab
  • any failed group's contents view
  • the All Messages tab
  • the message details page

Managing deleted messages

The Deleted Messages tab will open showing messages deleted and not yet cleaned up according to the retention policy.

Deleted Messages Tab

To limit the set of displayed messages, select an option from the available predefined range.

Delete Filters

Each message on screen contains information about when it's scheduled for deletion. "Immediate deletion" means that the message has expired, and will be deleted the next time the deletion task runs.

Retention Countdown

See [Service Control Error Retention Period](/servicecontrol/servicecontrol-instances/configuration.md) to learn more about scheduling automatic disposal of deleted messages.

Deleted Message Groups

The Deleted Message Groups tab shows the deleted messages grouped by the following options:

  • Exception Type and Stack Trace - groups messages both by exception type and stack trace. It is the default way of categorizing failed messages.
  • Message Type - groups messages by message type.
  • Endpoint Address - groups messages by endpoint address where the failure occurred.
  • Endpoint Instance - groups messages by endpoint instance identifier where the failure occurred.
  • Endpoint Name - groups messages by name of the endpoint where the failure occurred.

Clicking on a group of messages will navigate to the Deleted Messages page containing all the messages from that group.

Restoring deleted failed messages

If there are failed messages that were deleted by mistake, they can be restored via the Deleted Messages tab. Once restored, they will be displayed in the Failed Message Groups and Failed Messages screen, where they can be retried or deleted again.

Restore Select

Restoring deleted groups of failed messages

Deleted groups of failed messages can also be restored by clicking on the respective "Restore group" button in the Deleted Message Groups tab.

Restore group