- 9 minutes to read

Resumable - Suspended Instances

Get alerts and manage the resumable suspended instances in BizTalk grouped by BizTalk application name using audited self-service enabled Monitor Views.

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!

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 that exists on every Resource within Nodinite.


What remote actions are available?

The following Remote Actions exists for Suspended instance(s) (resumable) Resources:

Remote Actions


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):
Manage Suspended Instances
Example of a list with an overview of all the currently suspended instances (resumable) for the selected BizTalk Server Application (by name)

Manage Actions for unsuppressed instances
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)
  • Download

  • 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 Actions for suppressed instances
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.

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

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.

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 menu download
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.
Suppress Action
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.
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 a list of historical suspended instances (resumable)

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.

Terminate All

When you click on the Terminate all menu item in the Action button you will be prompted to confirm operation:
Confirm intent - Really Terminate All

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 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
Statistics for Suspended instances