Page tree

This section presents parameters that you can modify in the BMC Application Diagnostics Agent policy file.


If a lock icon is displayed as a file attribute, you cannot edit the policy, but you can create a copy of the file and edit the copy:

  1. From the arrow menu at the upper-right corner of the pane, select Save As.
  2. Rename the policy and modify according to your requirements.


BMC recommends that you contact BMC Support when modifying the settings for the first time, to ensure that your modifications do not impact the system adversely. To change the policy settings, adhere to the following guidelines:

  • Each line in the policy file has only one property, in a name-value format.
  • The delimiter between a property name and its value is "=".
  • White spaces are ignored except within the value string (that is, between the first non-blank character after the "=" delimiter and the last non-blank character in the line).
  • Both Windows and UNIX linefeed markers are supported.
  • Hash marks (#) at the beginning of a line signify comments.
  • Property values can only be ASCII characters within the range of 0-127.
  • Do not change property names; you can only change values.


Changing any of the parameters in the policy files can have a sizable impact on the footprint of the BMC Application Diagnostics Agent and the BMC Application Diagnostics Collector’s scalability and database size. BMC recommends consulting with BMC Application Diagnostics support before changing any of the parameter values.

To perform this procedure, you must have Administrator-level access, or higher, or have tenant Application Owner-level access.

To edit a policy file

  1. From the Diagnostics tab, select Administration > Agent Policies.
  2. In the Name column, click the name of an editable policy file.
    Read-only files have a lock icon next to the file name.
  3. On the View Agent Policy File window, from the arrow menu at the upper-right corner of the pane, select Edit.
  4. On the Edit Agent Policy File window, modify the policy according to your requirements.
  5. Click Save.
  6. (Optional) Apply the policy to relevant agents or set it as a default policy.

In the following topics, some of the most common configuration settings are described:

Related topics

Creating a new Agent policy file

Applying a policy to an Agent

Setting the default Agent policy