You can modify automatic backend discovery rules and create custom backend discovery rules.
Modifying Backend Discovery
Modifying backend discovery rules involves specifying different backend naming conventions from the default convention.
This lets you:
- aggregate similar backends by reducing the number of properties used to name the backend.
- split backends by increasing the number of properties used to name the backend.
Creating Custom Backend Discovery Rules
Creating custom backend discovery rules allows you to customize identification and names of automatically discovered backends.
If automatic discovery for a backend type is enabled, the agent first processes any custom backend discovery rules for that type and then the automatic backend discovery rules.
If automatic discovery for a backend type is disabled, and one or more custom discovery rules is applied, the agent discovers only backends defined by the custom rules. For example, in this case, if you have a custom discovery rule that matches on “URL contains AppD” and another that matches on “Host starts with myHost”, the agent discovers only backends that match at least one of those criteria. If you have a single custom rule that matches on both “URL contains AppD” and “Host starts with myHost”, the agent discovers only backends that match both of those criteria.
Automatically discovered backends are listed in PHP Supported Environments. To enable the PHP Agent to discover a backend that is not automatically discovered, use the PHP Agent APIs to create a custom exit call. See PHP Agent API Reference.
Accessing PHP Backend Detection Rules
To access the PHP Agent's backend discovery rules, click Configuration > Instrumentation, then the Backend Detection tab, then the PHP subtab.
In the left panel select either the entire application of the specific tier for which you want to configure backend discovery.
In the Automatic Backend Discovery list, click the backend type that you want to view or modify.
A configuration summary for the selected backend type appears on the right. The Automatic Discovery panel shows which properties the agent uses by default to name the backend. Click Edit Automatic Discovery to modify the naming convention, enable or disable the rule, and (where possible) to enable or disable correlation through the backend to components that are further downstream.
In the Custom <backend type> Discovery Rules panel, click + to create or the pencil icon to modify custom rules for how the PHP Agent should discover and name backends of the selected backend type.