> 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.md).

# Usage & Budget

**Usage & Budget** helps you monitor resource consumption and control monthly spending — all within a single menu group on AgentBase.

***

## Overview

**Usage & Budget** contains two main pages:

| Page                | Description                                                                                                                                                | Access                                                        |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
| **Usage & Cost**    | Dashboard for viewing usage (requests, tokens, active agents) and cost by agent, provider, and model — with flexible filters and month-end cost projection | Root, Admin, Viewer (full org data); Member (own agents only) |
| **Budget & Alerts** | Set a monthly budget limit (VND) and configure automated alerts when spending approaches the limit                                                         | Root only                                                     |

***

## Key Features

### Usage & Cost Dashboard

A unified dashboard for org-wide usage and cost with multi-dimensional filters:

* **Global filters:** Agent (including **Others** — direct MaaS calls not routed through an agent), Provider, Model, API Key, Time Range
* **Usage tab:** Requests, Tokens, Active Agents; Requests over time chart; Token Breakdown chart; **Top Expensive Agent** table (top 10 agents by total cost, aggregated per agent)
* **Cost tab:** Total Cost, Budget Used %, Monthly Projection; Cost by Agent, by Provider, by Model; Monthly Cost Trend

### Budget & Alerts

Root sets a monthly budget limit in **VND** (fixed currency — no other currency option). When spending reaches a threshold:

* **80%:** Email alert sent to Root + yellow warning banner pinned to the **Usage tab**
* **100%:** Email alert sent + red warning banner pinned to the **Usage tab**

The budget automatically rolls over to the next month (always recurring) — no reconfiguration needed each month.

***

## Getting Started

| I want to...                               | Go to                                                                                             |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------- |
| View usage, cost, and month-end projection | [View Usage & Cost](/vng-cloud-document/ai-stack/agent-base/usage-budget/view-usage-cost.md)      |
| Set a budget limit and configure alerts    | [Configure Budget & Alerts](/vng-cloud-document/ai-stack/agent-base/usage-budget/budget-alert.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:

```
GET https://docs.vngcloud.vn/vng-cloud-document/ai-stack/agent-base/usage-budget.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.