This pageapplies toApigee andApigee hybrid.

View Apigee Edge documentation.

Apigee enables you to create alerts that are triggered by specific API traffic patterns— for example, when an API's error rate reaches a predetermined threshold. AAPI Ops extends this capability withanomaly alerts, which are triggered whenever Apigee detects unusual API traffic data. The advantage of anomaly alerts is that you don't have to define the exact conditions for each anomaly yourself. AAPI Ops determines the right anomaly conditions using statistical methods, and constantly updates them based on recent traffic data. Using anomaly detection, you let Apigee detect traffic and performance issues, rather than predetermining the alert conditions yourself.

When AAPI-Ops detects an anomaly, it displays the event in the Anomaly Eventsdashboard. However, it doesn't automatically raise an alert forthe anomaly. If you examine an anomaly in the dashboard and decide you want to be alerted aboutsimilar event in future, you can create an anomaly alertand set up a notification, which sends you a message whenever the anomaly is detected.

Check required permissions

Before creating an anomaly alert, make sure you have been assigned therequired rolesfor AAPI Ops.

Create an anomaly alert

To create an anomaly alert in the Alerting policy dashboard, do the following:

1. Open theCreate alerting policy> Add alert condition page.

   Go to Add alert condition

   
2. ClickSelect a metric.
3. In theFilter, typeanomaly.
4. If there are no results, clickActive to display all metric types.
5. ClickApigee environment.
6. ClickEnvironment.
7. ClickApigee anomaly event count.
8. ClickApply.
9. In theRolling window menu, select the time period.
10. In theRolling window function menu, selectdelta. This specifies how the data is aggregated over each time period, which you set in theRolling window field. With thedelta setting, the aggregated value equals the final data value in the time period minus the initial data value.
11. ClickNext.

12. On theConfigure alert trigger page, set theThreshold value to0.5. (Any number between 0 and 1 will work for the threshold.) With this value, a single anomaly exceeds the threshold and triggers the alert.

13. At this point, you can choose to either:

    • ClickAdd alert condition to create another condition for the alert, or
    • ClickNext to go to the next step, where you will have the option to create a notification for the alert.
14. If you don't want to create a notification at this time:
    • ClickNext.
    • Change theUse notification channel toggle toOff.
15. Enter anAlert policy name.
16. ClickCreate policy to save the alert.

Create a notification for an alert

If you want to be notified immediately when an incident occurs, you can create a notification for the alert. When the alert is triggered, Apigee sends you a notification. You can choose any of the following channels to receive the notification:

• Cloud Mobile App
• Email
• Google Chat (Preview)
• PagerDuty
• Pub/Sub
• Slack
• SMS
• Webhooks

1. If you just created the alert (as shown in the preceding example) and are currently viewing theCreate alerting policy dashboard, skip to the next step.

   Otherwise:

   • Open thePolicies page.

     Go to Policies

   • In the row for the alert you created, clickmore_vertView actions>Edit.
2. Ensure theUse notification channel toggle is on.
3. Select the notification channels you want to receive notifications. If you want to create a new notification channel, selectManage notification channels. See Create and manage notification channels for more details.
4. Most of the options on this page are optional. See Create alerting policy for more details.
5. In theName the alert policy section, enter anAlert policy name.
6. If you are creating a new alert policy, clickCreate policy. If you are editing an existing alert policy, clickSave policy.

When an alert is triggered, you will receive a notification providing a summary of the incident and when it occurred. The notification also contains information to help you investigate the incident.