Skip to main content

AppDynamics plugin

The Moogsoft Cloud AppDynamics plugin receives JSON event data on a specified port number and IP address, and forwards it to the Moogsoft Events API. The AppDynamics plugin must be configured and enabled to begin collecting metrics.

AppDynamics must also be configured to send data to the plugin.

When to use the AppDynamics plugin

Moogsoft offers two convenient mechanisms for integration with AppDynamics.

  • Use the Moogsoft AppDynamics plugin with the Moogsoft Collector when you:

    • Want to send AppDynamics data to the Moogsoft Events API or when you cannot install a collector on the same system as your SaaS product.

    • Don’t want to make direct outbound calls from your environment.

    • Can install a collector on a host in your environment and it will act as a proxy.

  • Use the Moogsoft AppDynamics Integration:

    • To ingest events from AppDynamics and send them to Moogsoft with automatic mapping.

    • When you can configure your AppDynamics instance to authenticate against a Moogsoft endpoint to send data to Moogsoft. This integration does not require a Moogsoft Collector and you can use authentication.

Install a Collector

Navigate to the Integrations > Ingestion Services > Collector tab to configure and enable Moogsoft Collector plugins. You can set up a collector plugin when you download a new collector, or any time thereafter when configuring an existing collector.

To use the AppDynamics plugin, you need to:

  1. Install the Moogsoft Collector on a host within your secure network, as the plugin does not use authentication.

  2. Navigate to the Ingestion Services > Collector tab to configure and enable collector plugins. Do not go directly to the Plugins tab, to configure the plugin, as the plugin needs to be associated with a specific collector to work properly.

You can set up a Moogsoft Collector plugin when you download a new collector, or any time thereafter when configuring an existing Moogsoft Collector.

Configure and enable the AppDynamics plugin

To use the AppDynamics plugin, you need to install a Moogsoft Collector. Once your collector is installed:

  1. Go to the Ingestion Services > Collectors page and select your specific collector.

  2. Click the AppDynamics plugin, located on the Plugins tab.

  3. Provide the parameter configuration information in the pop-up panel. The pop-up panel has an Overview and a Configuration tab and provides links to configure the AppDynamics plugin or install a collector.

Parameter configuration:

  1. In the Configuration tab of the AppDynamics plugin panel, define the following plugin parameters:

    • Address — Provide the address (IP address) that you want the collector to receive or listen on.

    • Port Number — Provide the port number that you want the collector to receive or listen on. Port number 8084 is set as the default port.

  2. Toggle on the Enable option when you are ready to start plugin data ingestion.

Configure AppDynamics

To get incidents and alerts, you also need to configure AppDynamics to send event data to the plugin. You can do this before or after you enable the plugin. For more help about configuring AppDynamics, see AppDynamics documentation.

To configure AppDynamics to send event data to the plugin, you must create a HTTP Request Template.

Create the HTTP request template

To create a new HTTP request template:

  1. Log in to AppDynamics and click the Alert and Respond tab.

  2. Click HTTP Request Templates in the left nav.

  3. Specify the settings as defined in the following table.

Template field

Value

Request URL endpoint

Method

POST

Name

Alert POST

RAW URL

The Moogsoft endpoint URL consisting of the name and port for the collector.

URL-Encoding

UTF-8

Enable authentication (as needed)

Authentication Type

Not required

User ID

Not required

Password

Not required

Custom request header

Content Type

application/json

apiKey

Your Moogsoft API key. For information on generating an API key, see Manage Moogsoft Cloud API keys.

Payload

MIME Type

application/json

Payload Encoding

UTF-8

Payload text

Specify the payload you want to send.

Example: Add the contents of this file to the field. Download example script.

Response handling criteria

Failure

Each HTTP request template must handle the following status codes: 400, 401, 405, 406, 200, and 202.

Success

200. For the 200 status code, make sure that Expect Payload is enabled and the Content Type is application/json.

Settings

One Request Per Event

Set to False (remove the checkmark)

Connect timeout

5000 (default)

Socket timeout

5000 (default)

Add the request template to AppDynamics policies

  1. Add your new HTTP request template to all AppDynamics policies that you want to observe in Moogsoft.

  2. In AppDynamics, choose Alert and Respond and then Policies.

  3. For each policy that you want to observe in Moogsoft, do the following:

    1. Enable all the event triggers that you want to observe in the Moogsoft UI.

    2. In the Actions tab, add the HTTP request template you just defined to the Actions to Execute tab.

After you complete the AppDynamics configuration, AppDynamics reports event data to your system.

Validate the plugin and AppDynamics integration

To validate the integration, you have the following options:

  • Test that the AppDynamics plugin collector can listen on the specified port number and IP address.

  • To see if AppDynamics succeeded in transmitting data to the plugin:

    • Check the Incidents > Incidents page or the Incidents > Alerts page to see if the AppDynamics data is flowing into the plugin.

    • Check the Collector Logs on the Collectors panel to help troubleshoot your installation and configuration.

Discover more

In this section: