Overriding resource usage settings for performance of apps for Office

apps for Office

This topic describes the registry settings that administrators can use to control performance-related thresholds for apps for Office.

Last modified: February 06, 2014

Applies to: Access app for SharePoint | Excel 2013 | Excel 2013 RT | Excel 2013 SP1 | Excel Online | Outlook 2013 | Outlook 2013 RT | Outlook 2013 SP1 | Outlook Web App | OWA for Devices | PowerPoint 2013 | PowerPoint 2013 RT | PowerPoint 2013 SP1 | PowerPoint Online | Project 2013 | Project 2013 SP1 | Word 2013 | Word 2013 RT | Word 2013 SP1

Note Note

This topic applies to only the Office rich clients that support apps for Office. In particular, in the rest of this topic, "Outlook" refers to only the Outlook rich client, but not Outlook Web App or OWA for Devices.

In this article
Overview
AlertInterval
MemoryAlertThreshold
RestartManagerRetryLimit
OutlookActivationAlertThreshold
OutlookActivationManagerRetryLimit
Additional resources

Host applications of apps for Office support registry keys that allow administrators to control the performance of these apps. The following are the keys supported by all Office host applications and their default values:

  • AlertInterval —the interval to check memory and CPU core usages. The default is 5 seconds.

  • MemoryAlertThreshold —memory usage threshold. The default threshold is determined dynamically based on available physical memory of the computer.

  • RestartManagerRetryLimit —tolerance for crashes. The default limit is 4 crashes.

Icon for mail apps for Office

In addition, for mail apps, administrators can create and set two other registry keys to control the maximum time that Outlook spends on evaluating regular expressions in a manifest.

These registry keys are not present by default in the Windows registry. Administrators create them initially if they want to fine-tune the performance of apps for Office. Also, users must restart the corresponding host application for that host application to recognize such settings.

There are three ways for an administrator to set these registry keys, listed in the following sections. The following is the order that a host application checks for the existence of these keys:

  1. If the host application supports group policy for app resource usage, the host application first looks for a group policy key.

  2. In the absence of a group policy key, the host application looks for an application-specific registry key.

  3. If an application-specific key is absent, the host application looks for a global registry key.

  4. If the host application does not find a global registry key, the host application uses the corresponding default value.

Group policy setting

Icon for mail apps for Office

Only the Outlook rich client and mail apps support group policies. Administrators can use a group policy to create a registry key under HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\15.0\WEF\Outlook. The registry setting is applicable only to Outlook.

Application-specific setting

Icon for mail apps for Office

Only the Outlook rich client and mail apps support application-specific setting. Administrators can create and use a registry key in the following Outlook-specific hive:

HKEY_CURRENT_USER\Software\Microsoft\Office\15.0\WEF\Outlook

These registry keys apply to all mail apps running on the Outlook rich client for the current user.

Global setting

Administrators can create and use a registry key in the general Office hive under HKLM:

HKEY_LOCAL_MACHINE\Software\Microsoft\Office\15.0\OSF

These global registry keys apply to all apps for Office, running on any Office rich client that supports apps for the local machine.

Description

Specifies the interval for the host application to check on the memory and CPU core usages of an app.

Registry type

REG_DWORD

Value

The number of seconds of the interval to check memory and CPU core usages. The default is 5.

Maximum

600

Minimum

5

Details

This setting governs how often the host application checks memory and CPU core usage for a running app. The default threshold for CPU core usage is 90%, to be checked over 3 intervals, the default being 3 checks over 15 seconds at intervals of 5 seconds.

If you do not configure this registry setting, the host application will use the default alert interval of 5 seconds.

If the app requires more than the specified memory or CPU core usage when a memory or CPU core check occurs, the host application of a content or task pane app will display a warning for the user, and the host application of a mail app will automatically disable the app.

Description

Specifies a threshold for memory usage by an app.

Registry type

REG_DWORD

Value

The physical memory usage limit, in MB, for an app. Setting a key to 0 disables the check for that type of device.

Maximum

1,500

Minimum

0

Details

By default the host application determines the threshold based on the available physical memory on the device and does not use an absolute limit. When a host rich client detects that physical memory usage on a device exceeds 80% of the available memory, the client starts monitoring apps memory usage, at a document level for content and task pane apps, and at a mailbox level for mail apps. At an interval set by the AlertInterval setting, the client warns the user if physical memory usage for a set of apps at the document or mailbox level exceeds 50%.

You can however explicitly use GPO to specify absolute MemoryAlertThreshold settings for client computers.

If the app requires more than the specified memory alert threshold when a memory check occurs, the host application of a content or task pane app will display a warning for the user, and the host application of a mail app will automatically disable the app.

Description

Specifies the number of attempts that a host application tries to restart an app.

Registry type

REG_DWORD

Value

The maximum number of restart attempts for an app that has crashed. The default is 4.

Maximum

11

Minimum

2

Details

This setting governs the number of restarts that are used for a running app. If you do not configure this setting, the host application will use the default restart limit of 4 occurrences.

If the app requires more than the specified number of restarts during a session, the host application will automatically disable the app.

Icon for mail apps for Office

Description

Specifies the threshold, in milliseconds, for evaluating all the regular expressions in a manifest of a mail app.

Registry type

REG_DWORD

Value

The number of milliseconds for the activation threshold. The default is 1,000.

Maximum

10,000

Minimum

100

Details

This setting governs whether Outlook will disable a mail app during activation. If the app requires longer than the specified threshold for Outlook to evaluate all the custom regular expressions in its activation rules, Outlook will automatically disable the app. If you do not configure this setting, Outlook will use the default activation alert threshold of 1,000 milliseconds.

Icon for mail apps for Office

Description

Specifies the limit to the number of repeated attempts to activate a mail app.

Registry type

REG_DWORD

Value

The number of retries for activating a mail app. The default is 3.

Maximum

5

Minimum

1

Details

This setting governs the retry limit that is used to determine whether Outlook will disable a mail app during activation. If an app fails to activate because evaluating its regular expressions takes longer than the limit specified by OutlookActivationAlertThreshold, and the number of attempts to activate during an Outlook session exceeds the OutlookActivationManagerRetryLimit threshold, Outlook will automatically disable the app. If you do not configure this setting, Outlook will use the default retry limit of three occurrences.

Show:
© 2014 Microsoft