AppDynamics Application Intelligence Platform

3.8.x Documentation

PDFs

Videos

Release Notes

Skip to end of metadata
Go to start of metadata

New in 3.8.4, AppDynamics lets you migrate transaction detection configurations for PHP entry points from one application to another using a REST API. Use the API to copy transaction detection configurations rather than manually re-configuring multiple applications in the Controller.

Import and Export Auto-Detected Entry Point Configurations

You can import and export all your entry point configurations or one entry point configuration in a single request. Lists of multiple entry point names are not supported.

You can import to or export from the following application-level  and tier-level configurations:

  • auto-detected entry point configurations

  • custom match rules

  • exclude rules

Guidelines for exporting entry point configurations:

  • Use the HTTP GET method.
  • Encode the URI using UTF-8 URL encoding.
  • The base URI is the source application and, optionally, the source tier for your configuration export.

    http://<controller host>:<controller port>/controller/transactiondetection/<application name>/<optional tier name>
  • The Controller exports the configurations to an XML file. If necessary, you can edit the XML file before you import it.
    For example, if you export all the auto-detected entry points but don't want to import them all, delete the ones you do not want from the file before import.

Guidelines for importing entry point configurations:

  • Export the auto-detected entry point configuration, custom match rule, or exclude rule from the Controller.
    Alternately, you can manually create the XML, but that option is more work for you.

  • Use the HTTP POST method.
  • Encode the URI using UTF-8 URL encoding.
  • The base URI is the destination application and, optionally, the destination tier for your configuration import.

    http://<controller host>:<controller port>/controller/transactiondetection/<application name>/<optional tier name>
  • Include the XML configuration as a file attachment to the request.

  • Use UTF-8 URL encoding of the URI before posting. For example, use the plus symbol "+" to replace the space character in the URI.

  • To overwrite an existing configuration with the same name see Overwrite Parameter.

  • A successful import request returns HTTP status code 200.

To import or export the configurations for all the auto-detected entry-points to or from an application

http://<controller host>:<controller port>/controller/transactiondetection/<application name>/auto

exports all the auto-detected entry point types for all agents: ASP.NET, Java, PHP, NodeJS, etc.

For example:

http://appdcontroller.example.com/controller/transactiondetection/Howdy+World+Travel/auto

produces the output in auto_all.xml.

To import or export the configuration for a single auto-detected entry point type to or from an application

http://<controller-host>:<controller-port>/controller/transactiondetection/<application name>/auto/<entry point type name>

Entry point types names are case insensitive. The following entry point type names are valid:

  • phpWeb
  • phpMvc
  • phpDrupal
  • phpWordpress
  • phpCli
  • phpWebService

For example:

http://appdcontroller.example.com/controller/transactiondetection/Bundy+Online+Shoes/auto/phpWeb

To import or export the configurations for all the auto-detected entry-points to or from a tier

http://<controller-host>:<controller-port>/controller/transactiondetection/<application name>/<tier name>/auto

For example:

http://appdcontroller.example.com/controller/transactiondetection/Bundy+Online+Shoes/Fullfillment/auto/

To import or export the configuration for a single auto-detected entry point type to or from a tier

http://<controller host>:<controller port>/controller/transactiondetection/<application name>/<tier name>/auto/<entry point type name>

For example :

http://appdcontroller.example.com/controller/transactiondetection/Bundy+Online+Shoes/Fullfillment/auto/phpWeb

Import and Export Custom Match Rules

To import or export a single custom match rule to or from an application

http://<controller host>:<controller port>/controller/transactiondetection/<application name>/custom/<entry point type name>/<custom rule name>

This example exports/imports a PHP MVC custom match rule named Sample MVC Rule.

http://appdcontroller.example.com/controller/transactiondetection/Bundy+Online+Shoes/custom/phpMvc/Sample+MVC+Rule

To import or export a single custom match rule to or from a tier

http://<controller host>:<controller port>/controller/transactiondetection/<application name>/<tier name>/custom/<entry point type name>/<custom rule name>

This example exports/imports a PHP MVC custom match rule named Sample MVC Rule from/to the Fullfillment tier.

http://appdcontroller.example.com/controller/transactiondetection/Bundy+Online+Shoes/FullFillment/custom/phpMvc/Sample+MVC+Rule

Import and Export Exclude Rules

To import or export a single exclude rule to or from an application

http://<controller host>:<controller port>/controller/transactiondetection/<application name>/exclude/<entry point type name>/<exclude rule name>

This example exports/imports a PHP Web Service exclude rule named My Web Service Exclude Rule.

http://appdcontroller.example.com/controller/transactiondetection/Bundy+Online+Shoes/exclude/phpWebService/My+Web+Service+Exclude+Rule

To import or export a single exclude rule to or from a tier

http://<controller host>:<controller port>/controller/transactiondetection/<application name>/<tier name>/exclude/<entry point type name>/<exclude rule name>

This example exports/imports a PHP Web Service exclude rule named My Web Service Exclude Rule from/to the Fullfillment tier.

http://appdcontroller.example.com/controller/transactiondetection/Bundy+Online+Shoes/Fullfillment/exclude/phpWebService/My+Web+Service+Exclude+Rule

Overwrite Parameter

Use the overwrite parameter to overwrite a configuration of the same name. Without this parameter, if the import encounters a configuration for a component of the same name, the request will fail.

For example, to import a configuration for a PHP Web custom match rule named "My Rule" to an application that has an existing "My Rule" custom match rule that you want to overwrite use:

http://appdcontroller.example.com/controller/transactiondetection/Bundy+Online+Shoes/custom/phpWeb/My+Rule?overwrite=true

The default is overwrite=false.