quota_throttle_expert

Diagnose AOAI deployment TPM exhaustion by reconciling capacity with App Insights token usage.

5|2|Updated Apr 28, 2026
One-click install
npx skills add https://github.com/aiappsgbb/awesome-gbb --skill quota-throttle-expert
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: quota_throttle_expert
Source: https://github.com/aiappsgbb/awesome-gbb/tree/main/skills/azure-sre-agent/references/plugins/gbb-foundry/skills/quota_throttle_expert
Command: npx skills add https://github.com/aiappsgbb/awesome-gbb --skill quota-throttle-expert

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you determine why Foundry hosted agents are hitting 429 “Quota exceeded”/“OperationLimitExceeded” by linking App Insights token utilization to the deployment’s configured TPM capacity.

Core Features & Use Cases

  • Capacity vs utilization diagnosis: Pulls deployment sku.capacity (TPM) and correlates it with token usage patterns over the failing window in App Insights.
  • Burst and bottleneck classification: Detects whether throttling is sustained saturation, short-lived burst behavior, noisy-neighbor dominance, or regional/standard-SKU quota limits.
  • Actionable remediation: Recommends the most appropriate next step (scale capacity or migrate to PTU, introduce rate limiting via APIM, or request quota increase / SKU strategy).

Quick Start

Use quota_throttle_expert to diagnose 429 throttling for your Foundry hosted model deployment over the last two hours and output peak TPM, capacity, utilization percentage, classification, and the single recommended Azure CLI action for remediation.

Frequently Asked Questions about quota_throttle_expert

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why am I getting HTTP 429 OperationLimitExceeded errors from my Foundry hosted AOAI deployment?

HTTP 429 OperationLimitExceeded errors occur when your AOAI deployment TPM capacity is exhausted by token usage. This Skill diagnoses throttling by correlating App Insights token utilization with deployment capacity to identify if saturation is sustained or burst-driven.

How do I diagnose AOAI TPM throttling using App Insights telemetry?

To diagnose AOAI TPM throttling, query the gen_ai.client.token.usage metric for your deployment model dimension in App Insights. This Skill computes utilization peaks over the failing window and classifies the throttle pattern to recommend a mitigation step.

What is the best way to fix AOAI quota exceeded errors during capacity planning?

Fixing AOAI quota exceeded errors requires reconciling deployment sku.capacity with observed token usage. This Skill recommends scaling capacity, migrating to PTU, introducing rate limiting via APIM, or requesting a quota increase based on the classified bottleneck.

Can I detect noisy-neighbor dominance causing TPM throttling on a standard-SKU AOAI deployment?

Yes, noisy-neighbor dominance causing TPM throttling on standard-SKU deployments can be detected. This Skill classifies throttle patterns including sustained saturation, short-lived bursts, noisy-neighbor dominance, and regional quota limits using App Insights utilization data.

Does this throttle diagnosis process execute Azure CLI commands to change deployment capacity automatically?

No, this throttle diagnosis process does not execute changes automatically. It reads Azure deployment metadata for sku.capacity and produces one reviewed mitigation step, such as an Azure CLI action for remediation, without applying the changes.