Priority-based throttling


Priority-based throttling is enabled by default starting in Dynamics 365 Finance version 10.0.19. To learn about how you can prepare your environment prior to updating to version 10.0.19, see FAQ document. To test this capability, configure the integration priorities on the Throttling priority mapping page.


KB 4615823 includes two important fixes that directly impact the priority-based throttling experience.

This fix ensures that 429 HTTP messages are sent when a throttling event occurs in your environment and that the events reflect the correct threshold calculations for your environment.

The fix is available as part of the quality update for 10.0.17. We recommend you install this version to ensure that your environment is ready for priority-based throttling.

Priority-based throttling introduces service protection settings that prevent the over-utilization of resources to preserve the system's responsiveness and ensure consistent availability and performance for environments running Finance and Operations apps.

You have the ability to set relative priority for the OData and custom service-based integrations, depending on your business-critical need for these integrations. The throttling manager will then honor these priorities set for these requests.

  • For OData and custom service requests, an error which states "Too many requests" will be sent when system health and performance are affected.
  • You can query throttling events on the Lifecycle Services Monitoring page.

The Throttling Priority Mapping page is used to assign priorities for integrations so that priorities can be honored when requests are throttled.

Setting appropriate priorities ensures that low-priority integrations will be throttled before high-priority integrations. For more information about how to set up integration, see Enable connectivity with external services.

There are two kinds of applications are supported in Microsoft Azure Active Directory (Azure AD):

  • User based - This flow uses a username and password for authentication and authorization.
  • Azure AD app based - A confidential client is an application that can keep a client password confidential. The authorization server assigned this client password to the client application.

For more information, see Authentication.

Configure priorities for integrations

After you have registered your service in Azure AD and in your Finance and Operations apps, you can set up priorities for integrations.


You must be assigned the System administrator or Integration priority manager role to complete the set up.

  1. In Finance and Operations apps, go to System administration > Setup > Throttling priority mapping.
  2. Select New.
  3. In the Authentication type field, select User or Azure AD application based on your integration scenario.
  4. If Azure AD application type is selected, in the Client ID field select the application that you registered in the Azure Active Directory application.
  5. If User type is selected, in the User ID field select an appropriate service account user ID.
  6. Assign the appropriate priority and then select Save.

Retry operations

When a request is throttled, the system provides a value indicating the duration before any new requests from the user can be processed. When a request is throttled and a 429 error occurs, the response header will include a Retry-After interval, which can be used to retry the request after a specific number of seconds. The following example shows this operation.

    if (!response.IsSuccessStatusCode) 
                if ((int)response.StatusCode == 429) 
                    int seconds = 30; 
                    //Try to use the Retry-After header value if it is returned. 
                    if (response.Headers.Contains("Retry-After")) 
                        seconds = int.Parse(response.Headers.GetValues("Retry-After").FirstOrDefault()); 

                    // Retry sending the request.


To have a successful onboarding experience with the throttling capability, you must also be able to monitor your OData and custom service integration patterns. Microsoft Dynamics Lifecycle Services (LCS), which is the administration center, contains a collection of monitoring and diagnostics tools that can help ensure that you have an accurate view of the environments you manage. For more information, see Monitoring and diagnostics tools in Lifecycle Services (LCS).

You can use a set of predefined queries to get raw logs for an issue. You can then export the logs for a more advanced analysis. The following types of queries are available:

  • All throttling events
  • Requests throttled

Access the Monitoring and diagnostics portal

  1. In LCS, open the appropriate project.
  2. In the Environments section, select the environment to view, and then select Full details.
  3. On the Environment details page, select Environment monitoring to open the Monitoring and diagnostics portal.
  4. On the Environment monitoring page, select the Activity tab to view the Raw logs page.
  5. Select the Query name, and then select All throttling events for all OData and custom services activities.
  6. Select the Query name, and then select Requests throttled for all OData and custom services requests that have been throttled.