> For the complete documentation index, see [llms.txt](https://docs.eseye.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.eseye.com/infinity/monitoring-and-alerts/about-infinity-alert-profiles.md).

# About Infinity alert profiles

Alert profiles are customisable threshold rules applied to a SIM for monitoring. When a SIM breaches a threshold, the alerting system triggers alerts, notifications, and actions such as changing the SIM status.

To access the Infinity alert profile:

1. On the left menu, select **Connect & Manage**.

   <figure><img src="https://3553167287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXGhN6gzyULR0TDJArp4a%2Fuploads%2FHuDS6gcoqbpOUF5XERf1%2Fimage.png?alt=media&amp;token=c1f4b82b-a5c3-4f5f-bfbf-0b328a1b32f7" alt="Connect &#x26; Manage menu option"><figcaption></figcaption></figure>
2. Select **Alerts** to view the alerts list.
3. Select the **Manage** tab to view the **Alert Profiles** list.

## Viewing Infinity alert profiles

Alert profiles contain the following information:

| Field          | Description                                                                                                                                                                                                                                                                                                                     |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Alert Profile  | A set of conditions and rules that monitor SIM usage, activity, and security. You can receive notifications when thresholds or events occur, such as exceeding data or voice-call limits, or detecting a SIM swap.                                                                                                              |
| Default        | ![Default alert profile indicator](https://3553167287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXGhN6gzyULR0TDJArp4a%2Fuploads%2Fs9vVcaFjuo7upmxeoNJv%2Fimage.png?alt=media\&token=c5f6a5e5-7e23-48d6-a5d5-d0c8d29f0306) Indicates this profile is the default for all SIMs in the current portfolio. |
| Active Devices | ![Active devices indicator](https://3553167287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXGhN6gzyULR0TDJArp4a%2Fuploads%2FJpM6F5RHGSbqNQC74R6Q%2Fimage.png?alt=media\&token=e94191ac-3515-40da-a69d-92f1e713073c) Indicates active devices use the specified alert profile.                           |
| Actions        | You can [update](#updating-alert-profiles) or [delete](#deleting-alert-profiles) the alert profile.                                                                                                                                                                                                                             |

## Creating alert profiles

Alert profiles contain the following thresholds:

| Alert type       | Description                                                                                        |
| ---------------- | -------------------------------------------------------------------------------------------------- |
| Finance Alerts   | Monitors cost limit thresholds.                                                                    |
| Data Alerts      | Monitors data consumption thresholds in Bytes, KB, MB, GB, or a percentage of monthly consumption. |
| Messaging Alerts | Monitors the number of SMS messages the SIM can send or receive (MO or MT).                        |
| Call Alerts      | Monitors maximum voice-call usage in a month, measured in seconds, minutes, or hours.              |
| IMEI Alert       | Detects IMEI changes, which indicate the SIM has moved to another device.                          |

To create an alert profile:

1. On the **Manage** tab, select **Add** to view the **New Alert Profile** form.

   ![](https://3553167287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXGhN6gzyULR0TDJArp4a%2Fuploads%2FRzDbdyhPeZVICxVbMxPd%2FInfinity_New-Alert-Profile.png?alt=media)
2. In **Name**, enter a profile name.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>If one or more alert profiles already exist, the <strong>Default profile</strong> checkbox appears alongside the <strong>Name</strong>. If only one alert profile exists, it is automatically assigned as the default.</p></div>
3. If required, select **Default profile** to assign this profile to all SIMs in the current portfolio.
4. Alongside an **Alert Type**, select **Add alert** to create a threshold.
5. Set **Action required** to one of the following options:

   * **Alert** displays an alert in the alerts list when a threshold is breached. It sends an email if you subscribe to notifications.

     For more information, see [Viewing alerts](/infinity/monitoring-and-alerts/about-infinity-alerts.md#viewing-alerts) and [Managing your Infinity user profile](/infinity/account-and-support/how-to-manage-your-infinity-user-profile.md).
   * **Suspend** temporarily suspends the SIM until the current billing cycle ends. It sends an email if you subscribe to notifications. The SIM remains on the network, but you cannot use it.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>At the next billing cycle, the SIM is unsuspended and becomes active for use.</p></div>

   ```
   For more information, see [Understanding the SIM lifecycle](/spaces/XGhN6gzyULR0TDJArp4a/pages/H5Y1wrM7xOf9zeUBwC2q).
   ```
6. Set the relevant threshold parameters:

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>You can set up to 3 alert levels for all the thresholds, except IMEI alert (which has only 1 alert level). Ensure that each added alert threshold exceeds the value of previously set thresholds.</p></div>

   | Alert type     | Parameters                                                                                                                                              |
   | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | Finance Alerts | **Cost limit threshold per month:** Enter the amount that triggers an alert when monthly spending reaches or exceeds that value.                        |
   | Data Alerts    | **Data usage limit per month:** Enter the KB, MB, GB, or percentage that triggers an alert when monthly data usage reaches or exceeds that value.       |
   | Message Alerts | **SMS usage per month:** Enter the number of messages that triggers an alert when monthly SMS usage reaches or exceeds that value.                      |
   | Call Alerts    | **Voice call usage per month:** Enter the seconds, minutes, or hours that trigger an alert when monthly voice-call usage reaches or exceeds that value. |
   | IMEI Alert     | Add a threshold that triggers an alert when the SIM moves to another device and its IMEI changes.                                                       |
7. Repeat this process to add further thresholds.
8. Select **Save** to commit your changes.

   The alert profile appears in the **Alert Profiles** list.

## Assigning an alert profile

To assign an alert profile to a SIM:

1. On the left menu, select **Connect & Manage** > **SIM and Device Search**.
2. In the **Search results** table, select the checkboxes alongside the relevant SIM details rows.
3. At the top right, select **Actions** > **SIM Actions** > **SIM Settings**.
4. In the **SIMs' Settings** dialog, select an option from the **Alert Profile** drop-down list.

   ![](https://3553167287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXGhN6gzyULR0TDJArp4a%2Fuploads%2FlX5i4h6o9AWx1WzJxUq3%2FInfinity_AlertProfile.png?alt=media)
5. Select **Update** to assign the alert profile to the selected SIMs.

## Updating alert profiles

To update existing alert profiles:

1. Select![](https://3553167287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXGhN6gzyULR0TDJArp4a%2Fuploads%2F3pSnQKuBd8IJ6W0L2aGk%2Fimage.png?alt=media\&token=24b2b02b-ce53-4bd5-ab54-576eb6e80148) alongside an alert profile.
2. Make your changes.
3. If required, select ![](https://3553167287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXGhN6gzyULR0TDJArp4a%2Fuploads%2FpTMFc07ohCdNOwxSKSMp%2Fimage.png?alt=media\&token=132a2945-ef2b-4ee0-afce-2cb72e4ccbb4) alongside an alert level.
4. Select **Save** to commit your changes.

   The updated alert profile appears in the **Alert Profiles** list.

## Deleting alert profiles

To delete existing alert profiles:

* Select ![](https://3553167287-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXGhN6gzyULR0TDJArp4a%2Fuploads%2FpTMFc07ohCdNOwxSKSMp%2Fimage.png?alt=media\&token=132a2945-ef2b-4ee0-afce-2cb72e4ccbb4)alongside an alert profile.

{% hint style="warning" %}
You cannot delete the default alert profile, or alert profiles that are linked to active devices.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.eseye.com/infinity/monitoring-and-alerts/about-infinity-alert-profiles.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
