---
title: Runtime Alerts
description: Runtime alerts
documentId: runtime-alerts
locale: en-US
---

**Runtime Alerts** allow monitoring the behavior of APIs.

You can configure alert triggers (sending messages by email, Slack, Microsoft Teams, Webhook, and/or WhatsApp) for the situation (event) you determine.

See below for some example benefits of this feature.

## Example Scenarios

<Tabs defaultTab="tab1">
  <TabList label="tab1">
    <Tab tabId="tab1">Agility in problem identification</Tab>
    <Tab tabId="tab2">Support for business decisions</Tab>
  </TabList>
  <TabPanel tabId="tab1">
   
   ![Target](https://creative-ball-51b3fc85c0.media.strapiapp.com/runtime_alerts_case_ex_3_c9106ef17c.png) 

    Now the SRE (Site Reliability Engineering) team receives WhatsApp messages when a problem occurs and can take prompt action. I configured runtime alerts based on status 500 responses and set exactly the message to be sent for each situation, pointing out possible solutions to speed up response. Additionally, POST requests are sent to the system that creates reports for analysis and management planning.
  </TabPanel>
  <TabPanel tabId="tab2">

  ![Signs in multiple directions](https://creative-ball-51b3fc85c0.media.strapiapp.com/runtime_alerts_case_ex_2_6b3a339128.png)

    My reconfiguration strategy included a testing period. I created some new APIs to observe their market acceptance. I configured runtime alerts to monitor the number of calls received for these APIs. By knowing the adoption rate of each during the testing period, I had the basis to define the best path forward for my sales expansion project.
  </TabPanel>
</Tabs>

In these and other scenarios, alerts work based on action policies. Each policy defines a specific scenario (event) with the rules for triggering the alert.

## Configuring Runtime Alerts

Configure policies to monitor API behavior and receive alerts when specific situations occur.

Previous versions of Flexible Actions required creating one alert per API.

Now, with the concept of policies, the process is much simpler: you create a **Runtime alert** policy and select the APIs you want to associate with the policy.

<Callout type="tip" title="TIP">
Click this link to [understand how monitoring policies work](/docs/flexible-actions/creating-runtime-alerts#funcionamento).
</Callout>


### Step by step

- [Creating a new policy](/docs/flexible-actions/creating-runtime-alerts)
- [Editing policies](#editing-policies)
- [Removing policies](#removing-policies)

---

### Detailed description

- [Policy listing](#detailed-description)
  - [Search](#search)
  - [Policy details](#policy-details)

---

## Detailed description

### Policy listing

![Example policy list](https://creative-ball-51b3fc85c0.media.strapiapp.com/runtime_alerts_main_screen_6274f66e5c.png)

The policy list displays information and action options in the following columns:

- **CLASS**, with the policy classification, indicating its level of criticality:

  - ![Neutral](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_class_grey_99e0fbad65.png) Neutral
  - ![Success](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_class_green_dd0847d3d8.png) Success
  - ![Warning](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_class_yellow_a67c4c6cf2.png) Warning
  - ![Critical](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_class_red_522e0b58dd.png) Critical
- **NAME**, with the name given to the policy.

<Callout type="note" title="NOTE">
The policy name is unique.
</Callout>

- **TYPE**, which informs the category of parameters to be monitored, which can be:

  - Total Calls
  - Availability
  - Latency
  - HTTP Response Status

- **ACTIONS**, displaying the icons representing the notification channels:
  - ![Email](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_email_44e7ef7fd8.png) Email
  - ![Slack](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_slack_95e19def28.png) Slack
  - ![Teams](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_teams_85e5fa0f28.png) Teams
  - ![Webhook](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_webhook_4d1a26eddd.png) Webhook
  - ![WhatsApp](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_whatsapp_a31db6d279.png) WhatsApp

- **LAST UPDATE**, showing the date and time of the last configuration update.

- **ENABLED**, which brings a button to enable and disable notifications for the policy.

- **OPTIONS**, offering action options:
  - ![Details](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_overview_2f08ba138d.png): opens the page with more policy details:
    - Event parameters that trigger the alert.
    - Monitored items (API name; number of environments, resources, and operations; total monitored items).
    - Notification channels, including recipients, configured message, and, depending on the channel, a button to send a test message.
  - ![Edit](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_edit_new_bc2d39da4c.png): starts steps to edit the policy.
  - ![Delete](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_delete_new_c371bda946.png): deletes the policy.

---

### Search

Find a policy using the search tool at the top of the screen.

You can filter policies by the fields described below.
To see all fields, click ![Filter](https://creative-ball-51b3fc85c0.media.strapiapp.com/filter_b93272efbd.png).

![Example policy list](https://creative-ball-51b3fc85c0.media.strapiapp.com/runtime_alerts_filters_new_6b93eb7de3.png)

<Callout type="tip" title="TIP">
You asked and we delivered: now you can search by API name and policy name (alert name).
 </Callout>

- **API Name**: start typing the API name or click the field to select from a list.
- **Classification**: click and choose a criticality level (Neutral, Success, Warning, or Critical).
- **Tags**: start typing or select a tag (optional label added to policies during creation or editing to categorize them).
- **Status**: select a state (enabled or disabled).
- **Policy name**: type the policy name.
- **Notification Type**: select a notification type (Total Calls, Availability, Latency, or HTTP Response Status).
- **Action**: select the notification channel (Email, Slack, Microsoft Teams, Webhook, or WhatsApp).

---

### Policy details

Click ![Details](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_overview_2f08ba138d.png) in the **Runtime alert** policy list to see details about the policy, which are the information registered during the [new policy registration process](/docs/flexible-actions/creating-runtime-alerts).

The screen displays:

- Policy name
- [Monitored event details](/docs/flexible-actions/creating-runtime-alerts#monitored-event-details)
- [Monitored Items](/docs/flexible-actions/creating-runtime-alerts#2-monitored)
- Notification channels ([Actions](/docs/flexible-actions/creating-runtime-alerts#3-actions)), including recipients, configured message, and, depending on the channel, a button to send a test message.

---

## Editing policies

To edit the basic information of an alert (i.e., the monitoring conditions that will trigger a notification), follow the steps below.

<Steps>
  <Step>
   In the **Runtime alert** policy list, click ![Edit](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_edit_new_bc2d39da4c.png) in the **OPTIONS** column of the policy you want to edit.
  </Step>
  <Step>
  Make the desired changes.
   The steps are the same as for [creating new policies](/docs/flexible-actions/creating-runtime-alerts).
   The notification type (Total Calls, Availability, Latency, or HTTP Response Status) cannot be changed.

   <Callout type="tip" title="TIP">
   If you want to change the notification type, you can delete the policy and create a new one with the desired type.
</Callout>

  </Step>
  <Step>
   In step [4 REVIEW](/docs/flexible-actions/creating-runtime-alerts#4-review), check the changes and click **SAVE** to finish.

   <Callout type="warning" title="WARNING">
   You must click **SAVE** for the changes to take effect
</Callout>

  </Step>
</Steps>

<Callout type="note" title="NOTE">
- Changes will only apply from the next alert trigger.
- When you edit the **tags** of an alert, the new tags can be immediately used for searches on the Runtime Alerts screen. However, in searches on the [Triggered Alerts](/docs/flexible-actions/triggered-alerts) screen, the tags that were active when the alert was triggered will still be considered. For example, if you just added a new tag, it will only return search results in Triggered Alerts the next time the edited alert is triggered.
</Callout>

---

## Removing policies

Follow the steps below to delete an alert:

<Steps>
  <Step>
   In the **Runtime alert** policy list, click ![Delete](https://creative-ball-51b3fc85c0.media.strapiapp.com/icon_delete_8fb673c7f2.png) in the **OPTIONS** column of the policy you want to delete.
  </Step>
  <Step>
   Confirm deletion by clicking **DELETE** in the confirmation window.
  </Step>
</Steps>

<Callout type="tip" title="TIP">
If you just want to disable notifications for an alert indefinitely, instead of removing the policy, you can use the enable/disable buttons in the **ENABLED** column of the **Runtime Alerts** page.
</Callout>
