Additional Directives
You may need to set the following optional directives unless instructed by support:
-
AppDynamicsBackendNameSegments
: The number of URL segments that are displayed in the backend naming. This is only applicable for requests routing through the mod_proxy, when Apache is acting as a reverse proxy server, also-known-as a gateway server. Specify the rule configuration for backend naming in theappdynamics_agent.conf
file. The default value is 0 and only the IP address of the request URL is displayed. If you set a value of 2, then the first two segments along-with the IP address are displayed. Therefore for a request proxying tohttp://1.1.1.1/services/admin/abc
, the backend is named ashttp://1.1.1.1/services/admin
.For example:
AppDynamicsBackendNameSegments 2
-
AppDynamicsResolveBackends
: Controls the way Apache module backends appear in the Controller UI. If ON, metrics for Apache modules are shown as part of downstream tiers or backends. Module backends do not appear on flow maps. IfOFF
, Apache module backends appear in the flow maps with their own metrics. See Apache Modules. Defaults toON
. Optional.For example:
AppDynamicsResolveBackends OFF
-
AppDynamicsTraceAsError
: IfON
, tracepoints are written as errors to the Apache logs, by defaulterror_log
. Default isOFF
. Optional.AppDynamicsTraceAsError OFF
AppDynamicsReportAllInstrumentedModules
: IfOFF
, the agent reports only modules that occur during theHANDLER
stage of Apache request processing. IfON
, the agent reports modules during all stages of Apache request processing. The default isOFF
.For example:
AppDynamicsReportAllInstrumentedModules OFF
-
AppDynamicsLaunchProxy
: IfON
, the agent launches the proxy automatically when on startup. IfOFF
, you need to manually launch the proxy. If your system uses any command to do a graceful restart of Apache, such as log rotate, or if your system encounters heavy loads, you should set this property toOFF
. The default isOFF
.AppDynamicsLaunchProxy OFF
For information about how to examine and resolve proxy issues that may prevent an application agent from connecting to the Controller, see Dynamic Language Agent Proxy.
You may want to launch the proxy manually for debugging. For example, to set a different proxy root directory or runtime directory or to output additional debugging information.
-
A
ppDynamicsProxyJreDir
: Specify the JRE path.Warning: This parameter applies only to the AIX platform. This parameter becomes mandatory ifAppDynamicsLaunchProxy
is enabled. However, the JRE path gets discarded ifAppDynamicsLaunchProxy
is disabled, in this case, you must launch the proxy manually. See Launch the Proxy. -
AppDynamicsRequestCacheCleanupInterval
: Timeout in milliseconds after which the request cache is cleaned up by Java proxy. Proxy consists of a queue that takes all the requests from the agents and stores these requests for processing. Sometimes, this message queue can have an enormous cache within an interval of a minute under high load scenarios. Therefore as a preventive measure, a cleanup timer with a default value of 60 secs is available. To monitor long transactions, increase the cleanup interval, but you must be vigilant of the high cache or memory usage.For example:
AppDynamicsRequestCacheCleanupInterval 120000
Note: If you are running the proxy manually, then while running thelaunch proxy
command add the following flag:--req-cache-cleanup-interval=120000
AppDynamicsProxyCommDir-
Path to the directory containing the domain control socket, which the agent uses to start a Splunk AppDynamics node. Defaults to <agent_install_directory>/logs/appd-sdk. If you modify this setting, make sure that the directory path does not exceed 107 characters, which is the Linux limit to the socket file name size. If the directory path is too long, you will get an error message when the agent attempts to start.AppDynamicsProxyCommDir <agent_install_directory>/proxy/altcommdir
- For Filtering sensitive-data and privileged information, see Filter Sensitive Data.