AppDynamics Integration

Overview

AppDynamics provides deep application performance monitoring (APM) and infrastructure visibility.

To integrate AppDynamics with our platform, we use an HTTP Request Template. Instead of sending AppDynamics' default complex payload, we use Velocity Template Language (VTL) to extract only the necessary variables. This formats the outgoing webhook to perfectly match our Event ➔ Alert ➔ Incident workflow.

Provider Configuration & Mapping

AppDynamics sends event severity as ERROR, WARN, or INFO. We map these specific text values to our platform's internal priorities.

Priority Mapping Config:

JSON

{
  "priority": {
    "field": "$.Severity",
    "options": [
      { "value": "ERROR", "label": "Error" },
      { "value": "WARN", "label": "Warning" },
      { "value": "INFO", "label": "Info" }
    ],
    "mapping": {
      "ERROR": "CRITICAL",
      "WARN": "MEDIUM",
      "INFO": "LOW"
    }
  }
}

Correlation (Fingerprint): We use $.IncidentNumber, which pulls from the AppDynamics ${latestEvent.id}. This unique ID allows our platform to track the alert and automatically resolve it when AppDynamics sends a recovery signal.

Setup Instructions

Step 1: Get Your Webhook URL

1. Log in to your alert management platform.

2. Go to Sources → Add Source.

3. Select AppDynamics as your provider.

4. Save the configuration and copy the https://api.itoc360.app/functions/v1/events URL.

Step 2: Create the HTTP Request Template

1. Log in to your AppDynamics Controller.

2. From the top navigation bar or left menu, click Alert & Respond.

3. Click HTTP Request Templates.

4. Click New to create a fresh template.

Step 3: Configure the Request Settings

Fill out the configuration form with your webhook details:

1. Name: Type a clear name (e.g., OnCall Platform Webhook).

2. Method: Select POST.

3. Raw URL: https://api.itoc360.app/functions/v1/events

4. Authentication: Leave this as NONE.

Under the Custom Request Headers section, click Add Header:

• Header Name: Content-Type

• Header Value: application/json

Under the Payload section:

1. MIME Type: Select application/json.

2. Paste the following VTL-formatted JSON into the text area:

JSON

{
  "incident_name": "${latestEvent.displayName} – ${latestEvent.node.name}",
  "severity":      "${latestEvent.severity}",
  "description":   "${latestEvent.summaryMessage}",
  "app_name":      "${latestEvent.application.name}",
  "node_name":     "${latestEvent.node.name}",
  "event_id":      "${latestEvent.id}",
  "event_guid":    "${latestEvent.guid}",
  "event_type":    "${latestEvent.eventType}",
  "monitor_url":   "${latestEvent.deepLink}",
  "policy_name":   "${policy.name}",
  "time":          "${latestEvent.eventTime}",
  "message":       "${latestEvent.eventMessage}"
}

Under the Settings section:

1. Check the box for One Request Per Event. This ensures alerts are sent individually and not batched together.

2. Click Save.

Step 4: Test the Template

1. Scroll to the bottom of your saved template and click Test.

2. Click Add Event Type and select an event like Health Rule Violation Started - Warning.

3. Click Run Test.

1. A green SUCCESS status indicates the payload was successfully delivered to your platform.

Step 5: Create an Action

After testing the template, you must save it as an executable Action.

1. Go back to the Alert & Respond menu and click Actions on the left sidebar.

2. Click Create Action.

3. Select Make an HTTP Request and click OK.

1. Name: Type a name for this action (e.g., OnCall Platform Webhook).

2. HTTP Request Template: Select the template you created in Step 3 from the dropdown menu. The URL and Payload will auto-populate.

3. Click Save.

Step 6: Link the Action to a Policy

To automate the webhook, you need to attach this Action to a monitoring Policy. When the policy triggers an alert, it will execute the webhook.

1. In the Alert & Respond menu, click Policies.

2. Click Create Policy. (If a setup wizard appears, click Create Policy Manually under Quick Links).

1. In the Trigger tab, define which events should trigger the alert. For example, check the boxes for Health Rule Violation Events (Warning, Critical, etc.).

You should choose;

• Health Rule Violation Started - Critical

• Health Rule Violation Started - Warning

• Health Rule Violation Ended - Critical

• Health Rule Violation Ended - Warning

1. Go to the Actions tab at the top.

2. Click the + button to select an action. Choose your newly created OnCall Platform Webhook action and click Select.

1. Click Save to activate the policy. You will now see your active policy properly linked to the webhook action.

---