Update the BizTalk group settings
Using the Settings Dashboard, you can modify the configuration information used across all machines in a given BizTalk group. This topic provides the step-by-step procedure to modify the group-level performance settings in BizTalk Server. These settings are applicable for all the machines in a given group.
Note
You can also modify the host and host instance settings. For more information, see How to Modify Host Settings and How to Modify Host Instance Settings.
The current BizTalk Server settings can be exported to an XML file. Later, you can import those settings to the Settings Dashboard instead of setting up new values. For information on importing or exporting the BizTalk Server settings, see Import or export BizTalk Settings Using Settings Dashboard and Import or export BizTalk Settings Using BTSTask.
Prerequisites
Sign in as a member of the BizTalk Server Administrators group.
Update the group-level settings
In the BizTalk Server Administration Console, expand BizTalk Server Administration, right-click BizTalk Group, and then click Settings.
In the BizTalk Settings Dashboard dialog box, on the Group page, do the following:
Configuration refresh interval: Set the interval for BizTalk Server to refresh the messaging configuration, from 1 - 43200.
Message Batch Threshold: If the total size of an incoming message batch exceeds this value, then it is split into smaller batches and processed. Enter a value between 1 - 10000000. Default value is
1000000
(977KB).In an upgrade, the
HKEY_LOCAL_MACHINE\Software\Microsoft\BizTalk Server\3.0\Administration\TransformThreshold
value is copied.Large message size: Set the threshold size of an individual message that triggers streaming in a batch and/or during transformations. Enter a value between 1 - 10000000. Default value is
102400
(100KB).In an upgrade, this value is set to the maximum of the existing Large message size and LargeMessageFragmentSize values.
Enable fault tolerance: When set to On, receive locations recover from transient errors, and aren't disabled. When set to Off (default), receive locations with transient errors are disabled in the faulty host instance, and BizTalk tries to recover the receive locations using the Retry interval value you enter. The receive location continues to run in other host instances.
This setting applies to:
- BizTalk Server 2020 and newer
Retry interval: Set the interval, from 1 – 43200, for BizTalk server to recover receive locations from failures. Default value is
60
.This setting applies to:
- BizTalk Server 2020 and newer
Message box performance counter sampling interval: Enter the interval to refresh the performance counters, from 1 – Maximum value of type Integer. The interval trades off load on database versus up-to-dateness of counters. The higher value means less frequently updated data, and lesser load on the database.
In an upgrade, if there's an existing value, then the largest value on any server in the BizTalk group is used. If not, the default is used.
Enable group level tracking: Select On to turn the group level tracking for BizTalk Server on. Turning off global tracking disables the tracking interceptors for the entire BizTalk Server group. So, BizTalk Server will not track events in its tracking tables. This setting doesn't impact BAM Tracking. Default is On.
Allow import of tracking settings: Select On to allow import of tracking settings when a binding file is imported. When unchecked, import of binding file will not impact BizTalk application artifact tracking settings. Default is On.
This setting applies to:
- BizTalk Server 2016 and newer
Audit management operations: Select On to enable audit of management operations. Default is Off.
This setting applies to:
- BizTalk Server 2020 and newer
Maximum number of audit entries: Enter the maximum number of audit logs to keep in the audit store, from 1 – Maximum value of type Integer. BizTalk will automatically delete oldest records when number of audit entries exceeds this number. Default is
10000
.This setting applies to:
- BizTalk Server 2020 and newer
Enable group-level analytics: Select On to use Azure Application Insights and Azure Event Hubs to monitor your BizTalk applications. Default is Off.
This setting applies to:
- BizTalk Server 2020 and newer
- BizTalk Server 2016 Feature Pack 1 and newer
Target type: Select Azure Application Insights or Azure Event Hubs to send analytics data.
This setting applies to:
- BizTalk Server 2020 and newer
- BizTalk Server 2016 Feature Pack 1 and newer
Connection parameters: Enter connection parameters of the Azure service where monitoring data is analyzed. You can manually enter the connection parameters, or sign-in to Azure and get connection details.
This setting applies to:
- BizTalk Server 2020 and newer
- BizTalk Server 2016 Feature Pack 1 and newer
Click Apply to apply the modifications and proceed to another tab. Or click OK to apply the modifications and exit the Settings Dashboard.
To restore the default settings, select Restore Defaults.
See Also
Use Settings Dashboard for BizTalk Server Performance Tuning