Resumable - Suspended Instances
Info
Get alerts and manage the Resumable Suspended Instances in BizTalk Server, grouped by the BizTalk application name using audited self-service enabled Monitor Views.
Here's an example of the Suspended instance(s) (resumable) resources as seen in a Monitor View.
Application Name=BizTalk Application name, 1 entry for each unique name
Category Name="Suspended instance(s) (resumable)"
Resource Name="Suspended instance(s) (resumable)"
- Remote Actions - Support the execution of remote actions
- State Evaluation - Monitors and evaluates the current numbers
Important
You should always first try to resolve suspended instances working with the resumable ones first. The not resumable instances will be automatically deleted by BizTalk when you successfully terminate or resume the resumable ones. If you have no resumable suspended instances left then the only purpose of the not resumable instances is to provide debug and trace information so you can find the root cause for the actual error. Eventually you must rid the not resumable instances!
Note
We do not recommend that you apply the Auto Healing feature on resources of this category; You should deal with these problems manually!
What is being evaluated for 'Suspended instance(s) (resumable)'?
The table below shows the different monitoring states:
| State | Status | Description | Actions | |
|---|---|---|---|---|
| Unavailable | Resource not available | Evaluation of the 'BizTalk Suspended Instances (resumable)' is not possible either due to network or security-related problems | Review prerequisites | |
| Error | Too many | Number of rows are above configured threshold | Manage suspended instances Suspended instances history Terminate all Edit thresholds | |
| Warning | Too many | Number of rows are above configured threshold or...... all suspended instances are suppressed | Manage suspended instances Suspended instances history Terminate all Edit thresholds | |
| OK | Within thresholds | Number of rows are below configured threshold | Manage suspended instances Suspended instances history Terminate all Edit thresholds |
Tip
The evaluated state may be reconfigured using the Expected State functionality on every Resource within Nodinite.
What remote actions are available?
The following Remote Actions exists for Suspended instance(s) (resumable) Resources:
- [Export to .CSV]
- Manage Suspended Instances
- Suspended instances history
- Terminate all
- Resume all
- Edit thresholds
- Metrics chart: Metrics
Export to .CSV
You can export all the rows in the search result to a delimited text file. This data is not limited to what is on the screen.
Manage Suspended Instances
When you click on the Manage Suspended Instances menu item in the Actions button, a modal loads with an Overview of the currently Suspended Instances (resumable):
Here's an example of a list with an overview of all the currently suspended instances (resumable) for the selected BizTalk Server Application (by name)
List of Actions for unsuppressed instances.
The following features are available from within this modal:
Resume
- All
- One by one
- Selected (at least one)
Resume with comment
- All
- One by one
- Selected (at least one)
Terminate
- All
- One by one
- Selected (at least one)
Terminate with comment
- All
- One by one
- Selected (at least one)
Suppress
- One by one
- Selected (at least one)
Suppress with comment
- One by one
- Selected (at least one)
View Details - Selected
View Context Properties - Selected
Reload content
Additional list of Actions for suppressed instances.
If all the suspended instances are suppressed, the Resource in the Monitor View evaluates in the Warning state. Additional suspended instances sets the Resource in the Error state. You can use this feature to get alerts for additional suspended instances. You can opt to add a user defined Comment; if you do not enter a user-defined comment, the system automatically generates one for you.
- Unsuppress
- One by one
- Selected (at least one)
- Unsuppress with comment
- One by one
- Selected (at least one)
When working with the 'Suspended instance(s) (resumable)', you can view the details and context properties but eventually you must manually rid these using either the resume or the terminate operation.
Resume Suspended Instances
Nodinite provides the following options for resuming suspended instances:
- Resume all - Resume all with just one click
- Single instance - Resume selected suspended instance one at a time
- Multiple instances - Resume all selected suspended instances with just one click
Do use the Monitoring Agent Database since you will have a backup with history and some details left if you accidentally Resume the wrong set of suspended instances
Resume Single instance
Removing suspended instances one by one is a tedious process but proves that you dig into the problem before just resuming them and the actual problems rolls over to someone else.
In the modal page loaded by using the Manage suspended instances action you can further click on the Resume menu item in the Actions button.
Multiple instances
In the modal page loaded by using the Manage suspended instances action you can check one or more suspended instances and resume them in one sweep by clicking on the With selected button and select the Resume menu item.
With selected options, select 'Resume'.
At least one suspended instance must be checked otherwise this button is not enabled
Terminate Suspended Instances
Nodinite provides the following options for terminating suspended instances:
- Terminate all - Remove all with just one click
- Single instance - Remove selected suspended instance one at a time
- Multiple instances - Remove all selected suspended instances with just one click
Do use the Monitoring Agent Database since you will have a backup with history and some details left if you accidentally remove the wrong set of suspended instances
Single instance
Removing suspended instances one by one is a tedious process but proves that you dig into the problem before just removing them and the actual problems rolls over to someone else.
In the modal page loaded by using the Manage suspended instances action you can further click on the Terminate menu item in the Actions button.
Multiple instances
In the modal page loaded by using the Manage suspended instances action you can check one or more suspended instances and remove them in one sweep by clicking on the With selected button and select the Terminate menu item.
With selected options, select 'Terminate'.
At least one suspended instance must be checked otherwise this button is not enabled
Download
Resumable instances may have one or more payloads. These can be downloaded in full since the Web Client like the BizTalk Server MMC limits the preview output (max number of characters of a message to preview is 1024 characters).
Nodinite provides the following options for downloading suspended instances:
- Terminate all - Download all with just one click
- Single instance - Download selected suspended instance one at a time
- Multiple instances - Download all selected suspended instances with just one click
Download Single instance
Downloading suspended instances one by one is a tedious process but proves that you dig into the problem before just removing them and the actual problems rolls over to someone else.
In the modal page loaded by using the Manage suspended instances action you can further click on the Download menu item in the Actions button.
Download Multiple instances
In the modal page loaded by using the Manage suspended instances action you can check one or more suspended instances and remove them in one sweep by clicking on the With selected button and select the Terminate menu item.
With selected options, select 'Download'.
At least one suspended instance must be checked otherwise this button is not enabled
Suppress
To mute the alert (happens when all instances are suppressed), click on the Suppress menu item.
Action menu item to suppress the suspended instance.
You can suppress multiple suspended instances using the With selected button.
Details
Click the small button to the left of the Actions button to expand the selected row with additional information about the suspended instance.
Example with general information about the suspended instance.
The information is divided into two tabs:
- Details - General information
- Messages
- Context - Context properties
- Part (body) (limited to first 1024 characters like the BizTalk MMC)
Message context
The context properties available at the time of the suspend operation are available in the 'Messages' Context tab. The table can be filtered for your convenience and speed to find the information you seek.
Here's an example of filtered list of context properties for the suspended instance.
Part (body)
The selected message may have a body part which can be previewed in the default UTF-8 encoding. If the message is of another encoding you will need to Download it. If the message was tracked with Nodinite you can work with different encodings directly in the Log Views where the monitoring limit of 1024 characters does not exist.
Here's an example of payload from selected body part.
BizTalk has the concept of multipart messages, meaning there can be more than one message attached with the suspended instance
Suspended Instances history
If you have configured the Nodinite BizTalk Server Monitoring Agent to use the Monitoring Agent Database the feature 'Suspended Instances history' will be enabled and available.
For the selected BizTalk Server Application you can review the history for 'Suspended instance(s) (resumable)'.
Example with a list of historical suspended instances (resumable).
Note
Active 'Suspended instance(s) (resumable)' entries are not part of the history
Warning
The historical suspended instances have limited information (Details and context properties are not preserved)
Terminate all
For the selected BizTalk Server Application you can terminate all active 'Suspended instance(s) (resumable)'. If you have configured the Nodinite BizTalk Server Monitoring Agent to use the Monitoring Agent Database feature then the active entries will also be added to the Suspended Instances history.
When you click on the Terminate all menu item in the Action button you will be prompted to confirm operation:
Edit thresholds
By default, all BizTalk Applications use the global thresholds set in the Configuration. You can manage individual thresholds by clicking on the Edit thresholds menu item in the 'Actions' button.
When you click on the Save button; The configuration for the selected BizTalk Server Application name will use specific configuration instead of the global values.
If you see this warning it means global values are currently being used for the selected BizTalk Server Application.
Metrics chart: Metrics
Click the 'Metrics chart menu item to load the modal with statistics. The following different types of charts can be selected (and further fine-tuned for interval etc.)
- Select metrics content
- Suspended instance(s) (resumable) - Default
- Suspended instance(s) (resumable) Per service - Intended to be used for customers with the standard edition of BizTalk Server where the number of Applications are limited
Here's an example of 'Suspended instance(s) (resumable)' statistics for the selected BizTalk Server Application.
Next Step
Monitor Views
Configuration
Spool count health check
Statistics for Suspended instances