> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/resilience-testing/chaos-engineering/use-chaos-engineering/probes/apm-probes/appdynamics-probe.md).

# AppDynamics probe

Features and specification of the AppDynamics probe

The AppDynamics probe allows you to query AppDynamics metrics and compare the results against specified criteria.

#### Prerequisites <a href="#prerequisites" id="prerequisites"></a>

To use the AppDynamics probe, you need:

* An active AppDynamics account
* Access to the AppDynamics API from the kubernetes execution plane
* Authentication credentials (either basic auth or OAuth token)

#### Interactive Setup Guide <a href="#interactive-setup-guide" id="interactive-setup-guide"></a>

Follow along with this interactive guide to learn how to configure AppDynamics probe:

{% embed url="<https://app.tango.us/app/embed/8a20f18d-a78a-4d2f-ac8c-5aef92a4243e?skipCover=false&defaultListView=false&skipBranding=false&makeViewOnly=false&hideAuthorAndDetails=true>" %}
Create AppDynamics APM Probe
{% endembed %}

#### Steps to configure <a href="#steps-to-configure" id="steps-to-configure"></a>

1. In Resilience probe section under chaos module, click on **New Probe** button

   ![Create AppDynamics Probe](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-466d102092ac9ed522d10ccaf4721e57421af017%2Fcreate-splunk-probe.png?alt=media)
2. Select the **APM Probe**
3. Provide the name of the probe and select **AppDynamics** under APM Type

   ![Select AppDynamics Probe](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-1e3f7119a761fe0bc1371b03b37db201868be343%2Fselect-appdynamics-probe.png?alt=media)
4. Under AppDynamics connector select connector
5. In Connector settings, you can either choose an existing connector or click **New Connector**

   ![AppDynamics Connector](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-707b8bf63841d83d5279c9efc505d02ad7ebf399%2Fappdynamics-connector.png?alt=media)
6. Provide the credentials of the appdynamics controller

   ![AppDynamics Connector](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-7ff49a4a19b38fd4b528100670aab336a73174e0%2Fcontroller-credentials.png?alt=media)

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>NOTE</strong></p><p>If you select <strong>API Client</strong> as the authentication type, ensure that the API client has at minimum the <strong>Applications &#x26; Dashboards Viewer (Default)</strong> role assigned.</p></div>
7. Select the delegate and verify the connection and click on **Finish**

   ![Delegate](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-f67f4608e3b8ecdf3fd6d78f93f5c6bf99369628%2Fdelegate.png?alt=media)
8. Now connector is created and selected, click on **Configure Details**

   ![Configure Details](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-83b6ac0ca4bd93e2a89813781750c082dccf716d%2Fconfigure-details.png?alt=media)
9. Under Probe Properties, Pass the value of **AppDynamics Metric Full Path** and **Lookback Window**

   ![AppDynamics Lookback Window](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-0312289977f07dc4ca6a92aa28594b6d7a33287a%2Flookback-window.png?alt=media)

   * **AppDynamics Metric Full Path**:

     * A metric full path in AppDynamics is the complete hierarchical string that uniquely identifies a specific metric within an application for use in dashboards, alerts, and API queries
     * You can get the Metric Full Path from the Browse Metrics section in AppDynamics controller. For more details, refer to [AppDynamics docs](https://docs.appdynamics.com/appd/23.x/latest/en/appdynamics-essentials/metrics-and-graphs/metric-browser).
     * **Examples**:
       * `Application Infrastructure Performance|Root|Individual Nodes|boutique/adservice-54d59c5594-gggb9|Hardware Resources|CPU|%Busy`
       * `Application Infrastructure Performance|Root|Individual Nodes|boutique/adservice-54d59c5594-gggb9|Hardware Resources|Memory|Used (MB)`

     ![AppDynamics Metric Full Path](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-ea6fbcffd2d9a7e348d63e1bf8fa229b90ee3668%2Fmetric-full-path.png?alt=media)
   * **LookBack Window (In Minutes)**:
     * The lookback window refers to the time range from a specified number of minutes ago up to the current moment, over which data is aggregated
10. Provide the comparison criteria under AppDynamics Data Comparison

    ![AppDynamics Data Comparison](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-4b3347e8328aa19df3d1dbf945332d6384f44dad%2Fdata-comparison.png?alt=media)
11. Provide the Run Properties

    ![Create probe](https://2284173296-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlSkpbpeYJ3rfGUkIrcyQ%2Fuploads%2Fgit-blob-c606a8e1e6959c248708794284e6e310750a2989%2Fcreate-probe.png?alt=media)
12. Then click on **Create Probe**

{% @harness-feedback/feedback %}
