> For the complete documentation index, see [llms.txt](https://docs.vngcloud.vn/vng-cloud-document/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vngcloud.vn/vng-cloud-document/ai-stack/agent-base/usage-budget/budget-alert.md).

# Configure Budget & Alerts

> Guide for Root to set a monthly budget limit (VND), monitor spending, and configure automated alerts when costs approach the limit.

***

## Prerequisites

* Signed in with **Root** role (Budget & Alerts is Root-only; Admin and Member do not have access)

***

## Enable Budget Limit for the First Time

**Step 1: Open Budget & Alerts**

1. Go to **AgentBase** → sidebar → **Usage & Budget** → **Budget & Alerts**

**Step 2: Enter the limit and save**

1. Enter a value in the **Monthly Limit** field:

| Field             | Example       | Notes                |
| ----------------- | ------------- | -------------------- |
| **Monthly Limit** | `100,000,000` | Enter the VND amount |

> Currency is fixed at **VND** — no other currency option is available. **Enable Budget Unlimited** toggle: when turned ON, the system removes the monthly cap and allows unlimited spending. Leave it OFF to keep the limit active.

2. Click the confirm icon (✓) next to the input field to save

**Step 3: Confirm the budget is active**

After saving, the page shows:

* **Monthly Limit**: The VND value you set (with an edit icon)
* **Used This Month**: Current month's spending (VND)
* **Budget Usage** section: progress bar + percentage used + remaining VND
* **Budget Alerts** section: two alert toggles, both ON by default

***

## View Budget Status

When a budget is set, the **Budget Usage** section shows:

| Component               | Description                                                                                              |
| ----------------------- | -------------------------------------------------------------------------------------------------------- |
| **Progress bar**        | Solid color bar that changes by total %: green (0–69%) / yellow (70–79%) / orange (80–99%) / red (100%+) |
| **"X.XM / XXXM" label** | Used / Limit displayed at the right of the section title                                                 |
| **MaaS legend**         | MaaS — Model API calls · X,XXX,XXX VND · X%                                                              |
| **Runtime legend**      | Runtime — Agent compute · X,XXX,XXX VND · X%                                                             |
| **Monthly Projection**  | Estimated month-end spend (shown after ≥ 3 days have passed in the current month)                        |

***

## Configure Alert Thresholds

The **Budget Alerts** section shows two fixed thresholds — both are ON by default when a budget is set:

| Threshold                     | Action when reached                                                                              |
| ----------------------------- | ------------------------------------------------------------------------------------------------ |
| **Email alert at 80% usage**  | Email sent to the configured alert recipient — primary root contact will be notified.            |
| **Email alert at 100% usage** | Email sent to the alert recipient — agents continue running but immediate action is recommended. |

* **Alert recipient**: Enter the email address to receive alerts (editable field)
* Each threshold sends email only **once per month** — no repeated alerts on each cron run
* Click **Save Changes** after adjusting toggle states or updating the recipient address

{% hint style="warning" %}
Budget Alerts only **notify** — they do not automatically stop agents or block requests when the limit is exceeded. To reduce costs immediately, manually stop the Runtime.
{% endhint %}

***

## Edit Budget Limit Mid-Month

1. Click the ✏️ icon on the **MONTHLY LIMIT** KPI card
2. Enter the new value → click **Save**

**When increasing the limit:**

* `used%` recalculates immediately against the new limit
* All alert flags reset — the 80% and 100% thresholds apply to the new limit

**When decreasing the limit below current spending:**

{% hint style="warning" %}
If the new limit is lower than the amount already spent this month, a confirmation dialog appears:

> "New limit is lower than current spending (X VND). The org will immediately be in an over-budget state. Are you sure?"

Click **Confirm** to save — the system immediately sends the 100% alert email (without waiting for the cron job), and the progress bar turns red.
{% endhint %}

***

## Remove the Budget Cap

1. Turn on the **Enable Budget Unlimited** toggle
2. Confirm the dialog: "Enabling Budget Unlimited means charges will apply without a monthly cap. Continue?"
3. Click **Confirm**

After enabling:

* The Monthly Limit is disabled
* The Budget Alerts section becomes disabled (greyed out)
* The warning banner on the Usage tab in Usage & Cost disappears automatically

***

## Monthly Budget Reset

At 00:00 on the 1st of each month, the system automatically:

* Resets **Used this month** to 0
* Applies the same budget limit to the new month (always recurring)
* Resets alert flags (the 80% and 100% thresholds can trigger again in the new month)

***

## Result

| I want to...                                    | Go to                                                                                        |
| ----------------------------------------------- | -------------------------------------------------------------------------------------------- |
| View cost breakdown by agent / provider / model | [View Usage & Cost](/vng-cloud-document/ai-stack/agent-base/usage-budget/view-usage-cost.md) |
| Usage & Budget overview                         | [Usage & Budget](/vng-cloud-document/ai-stack/agent-base/usage-budget.md)                    |


---

# 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.vngcloud.vn/vng-cloud-document/ai-stack/agent-base/usage-budget/budget-alert.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.