# Budget Monitoring Revenium's Budget Monitoring Dashboard provides real-time visibility into AI spending and usage tracked against [Budget Threshold alerts](https://docs.revenium.io/pages/WsM0b2ZleAWlYZ8G0lv1#id-2.-budget-threshold). When you configure a Budget Threshold alert, the system automatically creates a corresponding budget entry that appears on the Budget Dashboard, giving you continuous visibility into your spending trajectory—showing you exactly where you stand against your limits at any moment. The Budget Dashboard gives you a comprehensive view of all your active Budget Threshold alerts, their current status, risk levels, and how they're tracking against expected linear pace—so you can take action before budgets are exceeded. ## How Budget Monitoring Works Budget monitoring is powered by Budget Threshold alerts. When you create a Budget Threshold alert in the Alert Configuration interface, the system automatically: 1. Creates a budget entry that appears on the Budget Dashboard 2. Tracks actual spending/usage against the configured threshold 3. Calculates risk levels based on percentage used 4. Monitors pace to show if you're ahead or behind expected trajectory 5. Sends notifications when thresholds are exceeded (via the alert system) The Budget Dashboard provides visibility into these budgets with: * **Cost Control**: View spending limits across different dimensions (providers, models, customers, products) * **Proactive Management**: See risk levels and pace indicators before budgets are exceeded * **Multi-Dimensional Tracking**: Monitor budgets for individual entities or groups of entities * **Period-Based Planning**: Track budgets aligned with business cycles (daily, weekly, monthly, quarterly) * **Early Warning System**: Risk-based indicators help you identify budgets approaching their limits *** ## Budget Portfolio Overview The Budget Portfolio provides an at-a-glance view of all your active budgets with key summary metrics:

Budget Portfolio showing all active budgets with risk levels and usage

### Summary Cards * **Total Budgets**: Count of all active budget alerts * **At Risk**: Number of budgets in high or critical risk status * **Total Spend**: Aggregate spending across all cost-based budgets * **Average Usage**: Average percentage used across all budgets ### Filtering and Sorting Quickly find specific budgets using: * **Search**: Filter by budget name, metric, or ID * **Period Filter**: Show only budgets for specific time periods (Daily, Weekly, Monthly, Quarterly) * **Sort Options**: * Risk (High to Low) - Default, shows most critical budgets first * Name (A-Z) * Usage (High to Low)

Filtered view showing only at-risk budgets

*** ## Budget Types Revenium supports two types of budgets to match different monitoring needs: ### Single Budgets Track spending or usage for a specific scope with optional filters. * Monitor total cost for a specific provider (e.g., OpenAI) * Track token usage for a particular model * Set limits on spending for a specific product or agent * Apply multiple filters to narrow the scope **Example**: "Customer Support AI - GPT-4" tracks total cost where Provider = OpenAI ### Grouped Budgets Set per-entity budget limits across a dimension, with aggregate tracking. * Budget per customer, with overall visibility across all customers * Budget per API key, tracking each key individually * Budget per product, monitoring each product's usage * Budget per organization, agent, or model **Example**: "Customer Accounts - Input Tokens" sets a 500,000 token limit per customer organization, tracking every customer organization separately against this limit, and also providing aggregate visibility in the Budgets Dashboard. For large groups like 'all customers', the dashboard will report the top orgganizations closest to their limit, and the API can be used to retrieve a complete list of customers and their usage. *** ## Tracked Metrics Budgets can be configured for the following metrics: | Metric | Description | Use Case | | ------------------ | ----------------------------- | --------------------------------- | | Total Cost | Total cost incurred | Overall spending control | | Token Count | Total tokens processed | General usage limits | | Input Token Count | Total input tokens processed | Control prompt/input costs | | Output Token Count | Total output tokens generated | Limit generation/completion costs | *** ## Time Periods Budgets automatically reset at the start of each new period: * **Daily**: Resets at midnight each day * **Weekly**: Resets at the start of each week * **Monthly**: Resets on the first day of each month * **Quarterly**: Resets at the start of each quarter The dashboard shows time remaining until the next reset (e.g., "Resets in 26 days"). *** ## Risk Levels Budgets are automatically categorized into risk levels based on percentage used: | Risk Level | Threshold | Color | Meaning | | ---------- | --------- | ------ | -------------------------------------------- | | Low | < 60% | Teal | Budget is well within limits | | Medium | 60-79% | Yellow | Budget usage is elevated, monitor closely | | High | 80-94% | Orange | Budget is approaching limit, action needed | | Critical | ≥ 95% | Red | Budget is at or near limit, immediate action |

Gauge chart showing budget usage with risk-based color coding

*** ## Budget Detail View Click any budget card to see detailed information and tracking metrics. ### Single Budget Details

Detailed view of a single budget showing gauge chart and tracking metrics

The detail view includes: * **Gauge Chart**: Visual representation of budget usage with risk-based colors * **Current Value**: Current spending or usage amount * **Threshold**: Budget limit * **Remaining**: Amount remaining before limit is reached * **Percent Used**: Percentage of budget consumed * **Budget Scope**: Filters applied to this budget * **Linear Pace**: Comparison to expected linear spending * **Period Progress**: Time elapsed in the current period ### Grouped Budget Details

Grouped budget showing per-entity limits and aggregate tracking

Grouped budgets show: * **Budget Summary**: Aggregate metrics across all entities * Budget per Entity * Total Groups * At Risk count * Aggregate Current value * Overall % Used * **Group Details Table**: Per-entity breakdown showing: * Group Name * Budget Limit * Current Value * % Used * Remaining * Period dates * Risk Level *** ## Pace Tracking Budgets include pace indicators to help you understand if spending is ahead or behind expected trajectory. * **Behind Pace**: Spending is lower than expected based on time elapsed (shown in orange) * **Ahead of Pace**: Spending is higher than expected based on time elapsed (shown in teal) **Example**: For a monthly $5,000 budget, if 65% of the month has elapsed, linear pace expects $3,250 spent. If actual spending is $4,250, the budget is $1,000 behind pace (spending faster than expected). *** ## Best Practices ### Start with High-Level Budget Alerts Begin by creating broad Budget Threshold alerts (e.g., total monthly AI spend) before creating granular alerts for specific use cases. ### Use Grouped Budget Alerts for Multi-Tenant Scenarios If you have multiple customers, products, or API keys, configure Budget Threshold alerts with the "Group By" option to create grouped budgets that provide both per-entity limits and aggregate visibility. ### Align Periods with Business Cycles When configuring Budget Threshold alerts, choose cumulative periods that match your planning and billing cycles for easier reconciliation. ### Monitor Risk Levels Regularly Check the "At Risk" summary card frequently to identify budgets approaching their limits. ### Configure Budget Threshold Alerts Budgets displayed on the Budget Dashboard are created by configuring Budget Threshold alerts. To create a new budget: 1. Navigate to **Budgets & Alerts** → **Alert Configuration** 2. Click **Create New Alert** 3. Select **Budget Threshold** as the alert type 4. Configure your budget parameters (metric, threshold, period, filters) 5. Set up notification channels (email, Slack) 6. Save the alert The new budget will automatically appear on the Budget Dashboard. See [Cost & Performance Alerts](/cost-and-performance-alerts.md) for detailed alert configuration instructions. *** ## Common Budget Scenarios These scenarios show how to configure Budget Threshold alerts that will appear on the Budget Dashboard: ### Scenario 1: Department-Wide Monthly Budget **Goal**: Track total AI spending for the customer support team against a target of $10,000/month **Alert Configuration**: * **Alert Type**: Budget Threshold (Cumulative Usage) * **Metric**: Total Cost * **Cumulative Period**: Monthly * **Threshold**: $10,000 * **Filters**: Agent contains "support", or Organization contains "support" (depending on your tagging strategy) * **Notifications**: Email finance team and post to Slack when threshold is exceeded ### Scenario 2: Per-Customer Token Limits **Goal**: Ensure no single customer exceeds 500,000 input tokens per month **Alert Configuration**: * **Alert Type**: Budget Threshold (Cumulative Usage) * **Metric**: Input Token Count * **Cumulative Period**: Monthly * **Threshold**: 500,000 * **Group By**: Organization * **Notifications**: Email & Slack account manager when any customer exceeds limit ### Scenario 3: Daily Spending Cap **Goal**: Prevent runaway costs with a daily spending limit across all AI usage **Alert Configuration**: * **Alert Type**: Budget Threshold (Cumulative Usage) * **Metric**: Total Cost * **Cumulative Period**: Daily * **Threshold**: $1,000 * **Filters**: None (all transactions) * **Notifications**: Slack alert to engineering team ### Scenario 4: Provider-Specific Quarterly Budget **Goal**: Track quarterly spending with OpenAI separately from other providers **Alert Configuration**: * **Alert Type**: Budget Threshold (Cumulative Usage) * **Metric**: Total Cost * **Cumulative Period**: Quarterly * **Threshold**: $50,000 * **Filters**: Provider = OpenAI * **Notifications**: Email FinOps team *** ## Summary Revenium's Budget Monitoring Dashboard provides proactive, real-time visibility into AI spending and usage tracked against Budget Threshold alerts. Budgets are automatically created when you configure Budget Threshold alerts in the Alert Configuration interface. With risk-based indicators, pace tracking, and support for both single and grouped budgets, teams can maintain cost control while scaling AI workloads confidently. To create a new budget, configure a Budget Threshold alert in the Alert Configuration interface. The budget will automatically appear on the Budget Dashboard with full tracking and visualization capabilities. For questions or to learn more about configuring Budget Threshold alerts, contact the Revenium team or see [Cost & Performance Alerts](/cost-and-performance-alerts.md). --- # Agent Instructions: 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.revenium.io/budget-monitoring.md?ask= ``` 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.