You can set health rules and policies for API monitoring to trigger alerts on API metrics and synthetic events. The alerts help you to determine problems in your APIs as they occur, or even before they occur. Further, AppDynamics can generate notifications or invoke actions based on conditions or events you configure.

Configuring alerts for API monitoring is supported in SaaS Controller >=22.8.

Alerts for Synthetic API Monitoring Metrics

You can use the following API monitoring metrics to trigger alerts:

  • Synthetic API TLS Time (ms)
  • Synthetic API 2xx - Successful
  • Synthetic API Total Time (ms)
  • Synthetic API TCP Time (ms)
  • Synthetic API Requests Count
  • Synthetic API First Byte Time (ms)
  • Synthetic API DNS Time (ms)
  • Synthetic API Wait Time (ms)
  • Synthetic API Response Size (Bytes)
  • Synthetic API Request Time (ms)
  • Synthetic API Download Time (ms)
  • 5xx - Server Error
  • 4xx - Client Error

Create Health Rules to Monitor Synthetic APIs

With health rules, you can define what is the normal or expected behavior of your APIs. See Configure Health Rules. 

To create a health rule for APIs:

  1. From the top navigation bar, click Alert & Respond.
  2. From the drop-down menu next to Alert & Respond, select the User Experience: API Monitoring entity.
  3. Click Health Rules.
  4. Do one of the following:
    1. To create a new health rule, click the + icon.
    2. To modify an existing health rule, select the health rule and click the Edit (pencil) icon.
  5. In the Overview tab, enter a name for your Health Rule. The other fields display default values and you can edit them based on your requirements.
  6. In the Affected Entities tab, you can select all APIs, a few specific APIs, or APIs with specific matching criteria to apply the health rule.



  7. In the Critical and Warning Criteria tabs, you can add conditions to trigger a health rule violation on the list of supported API metrics with fixed values or dynamic baseline thresholds. See Critical and Warning Conditions. 





  8. Click Save to complete the configuration.

Create Policy for Synthetic APIs

You can create policies to send alerts when the health rules for your APIs violate. You are notified about these alerts via an email, SMS, JIRA, or HTTP webhooks. See Configure Policies. 

To create policies for APIs:

  1. From the top navigation bar, click Alert & Respond.
  2. From the drop-down menu next to Alert & Respond, select the User Experience: API Monitoring entity.
  3. Click Policies.
  4. From the Policies page, click Create Policy Manually.
  5. From the Create Policy dialog, enter a name for your policy.
  6. From the Health Rule Violation Events list, select one or more specific events.


  7. In the Health Rule Scope tab:
    1. Select Any Health Rule to apply policy to all health rules.
    2. Select These Health Rules to apply policy to specific health rules.


  8. In the Object Scope tab, select Any Object.
  9. In the Actions tab, you add any existing actions you have already created or create a new action to be executed when any of the health rule violation events are triggered. See Actions. 
  10. Click Save to complete the configuration.

Alerts for Synthetic Jobs

You can use the following synthetic events to trigger policies:

  • Synthetic Availability
  • Synthetic Performance

Create Policy for Synthetic Events

Similar to APIs, you can also create policies to send alerts when the health rules for your synthetic events are violated. You are notified about these alerts via an email, SMS, JIRA, or HTTP webhooks. See Configure Policies.

To create policies for synthetic events:

  1. From the top navigation bar, click Alert & Respond.
  2. ​​From the drop down list next to Alert & Respond, select the User Experience: API Monitoring entity.
  3. Click Policies.
  4. On the Policies page, click Create Policy Manually.
  5. On the Create Policy dialog box, enter a name for your policy.
  6. From the Synthetic Availability list, select all the Synthetic Availability events or check one or more specific events. 
  7. From the Synthetic Performance list, select all the Synthetic Performance events or check one or more specific events.



  8. In the Object Scope tab:
    1. Select Any Object to apply policy to all synthetic jobs.
    2. Select These Specified Objects to apply policy to specific synthetic jobs.



  9. In the Actions tab, you add any existing actions you have already created or create a new action to be executed when any of the synthetic events are triggered. See Actions. 
  10. Click Save to complete the configuration.