- 8 minutes to read

Resumable - suspended instances

Get alerts and manage resumable suspended instances in BizTalk grouped by BizTalk application name

Resumable - suspended instances
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
NOTE: 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 this category; These problems should be dealt with manually!

What is being evaluated for 'Suspended instance(s) (resumable)'?

The evaluated state is provided by the table below:

State Status Description Actions
Unavailable Resource not available If the number of rows can't be evaluated 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 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 Expected State functionality that exists on every Resource within Nodinite.


What remote actions are available?

The following Remote Actions are implemented for the Suspended instance(s) (resumable) Resource:

Remote Actions

Manage Suspended Instances

When you click on the Manage Suspended Instances menu item in the Actions button a modal will be loaded with an Overview of the currently Suspended Instances (resumable):
Manage Suspended Instances
Example of list with an overview of all currently suspended instances (resumable) for the selected BizTalk Server Application by name

The following features are available from within this modal:

  • Resume
    • One by one
    • Selected (at least one)
  • Terminate
    • One by one
    • Selected (at least one)
  • Download
    • One by one
    • Selected (at least one)
  • View Details - Selected
  • View Context Properties - Selected
  • Reload page

Manage Actions button menu items

When working with 'Suspended instance(s) (resumable)' you can view the details and context properties but eventually you must manually rid these either resuming or terminating them.

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

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.

Actions menu resume

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 menu
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.

Actions menu remove
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 menu terminate
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
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.

Actions menu download
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.

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 menu download
With selected options, select 'Download'

At least one suspended instance must be checked otherwise this button is not enabled

Details

Click on the small button to the left of the Actions button to expand the selected row with additional information about the suspended instance.
Details
Example with general information about the suspended instance

The information is divided into two tabs:

  1. Details - General information
  2. 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.

Message context
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.

Body Part
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)'.
Suspended Instances history
Example with list of historical suspended instances (resumable)

Note: Active 'Suspended instance(s) (resumable)' entries are not part of the history

Limited details

NOTE: 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:
ReallyTerminateAll

Details

Click on the 'Details' button menu item to open the Details modal:
Details

Edit thresholds

By default all BizTalk Applications will 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.
Edit thresholds

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.

Save
If you see this warning it means global values are currently being used for the selected BizTalk Server Application

Metrics

Click on the 'Metrics chart menu item to load the modal with statistics. The following different type 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 lmited

Metrics Example of 'Suspended instance(s) (resumable)' statistics for the selected BizTalk Server Application


Next Step

Monitor Views
Configuration
Spool count health check
:file-chart-line: Statistics for Suspended instances

Suspended instances
Not resumable