Ansible Configuration for Apache Agent

The following is an example of Ansible® role to install Apache Agent:

---
- hosts: all
  tasks:
    - name: Include variables for the controller settings
      include_vars: vars/controller.yaml

    - include_role:
        name: appdynamics.agents.apache
      vars:
        agent_version: 22.12.1
        # possible value:
        #          - latest: Latest version
        #          - 22.12.1: Any Specific version number
        agent_type: apache
        agent_action: upgrade
        # possible value:
        #          - upgrade: upgrade currently installed agent to agent_version
        #          - install: install agent_version
        #          - rollback: rollback to previous backup if any
        #          - uninstall: uninstall and clean up everything

        # Apache specific Args
        #apache_conf_path:
        # possible value:
        #          - /etc/httpd/conf/httpd.conf #default path in case of RedHat
        #          - /etc/apache2/apache2.conf  #Default path in case of Debian
        #          - #any custom path where the conf file is located.

YML

Apache Agent Variables

The following variables are applicable to the appdynamics_agent.conf file. For more information, see Configure the Apache Agent.

Variable	Description
`appdynamics_enabled`	Set to `ON` to enable web server monitoring
`appdynamics_proxy_host`	Proxy server hostname or IP address
`appdynamics_proxy_port`	Proxy server port
`appdynamics_launch_proxy`	When set to `ON`, the agent launches the proxy automatically when on startup. If `OFF`, you must launch the proxy.
`appdynamics_resolve_backends`	Controls the way Apache module backends appear in the Controller UI.
`appdynamics_trace_as_error`	If `ON`, tracepoints are written as errors to the Apache logs, by default error_log.
`appdynamics_report_all_instrumented_modules`	If `OFF`, the agent reports only modules that occur during the HANDLER stage of Apache request processing.
`appdynamics_backend_name_segments`	The number of URL segments that are displayed in the backend naming.
`appdynamics_proxy_comm_dir`	Path to the directory containing the domain control socket which the agent uses to start an AppDynamics node. The default value is `<agent_install_directory>/logs/appd-sdk`.
`appdynamics_request_cache_cleanup_interval`	Timeout in milliseconds after which the request cache is cleaned up by Java proxy.
`appdynamics_mask_cookie`	Specify if filtering is enabled or not. Set it ON for cookie filtering to be enabled. The default value is OFF.
`appdynamics_mask_cookie_pattern`	Specify the pattern that when matched, filters the value of that cookie.
`appdynamics_mask_sm_user`	Specify if filtering is enabled or not. Set it ON for sm_user filtering to be enabled. The default value is OFF.
`appdynamics_delimiter`	Specify the character that you want to use as URL segment endpoints.
`appdynamics_segment`	Specify a comma-separated list to indicate the segments that you want the agent to filter
`appdynamics_match_filter`	The type of filter to be used to match the URL amongst the following: NOT_EMPTY
`appdynamics_match_pattern`	Specify the string that you want to be filtered with the match-filter
`custom_agent_config_path`	Specify the absolute path to the agent configuration file for future upgrades. Make sure that you add the agent configuration file path to the `apache.conf` file.

Ansible® is a registered trademark of Red Hat, Inc. in the United States and other countries.