AgentbaseDocs
文档目录

限额与配额

Agentbase 2.10.0 提供贯通账号(Account) → 组织(Organization) → 项目(Project)三级的标准化用量聚合视图(Usage Aggregates)、请求速率限制(Ratelimit)、资源配额(Quota)、大模型推理预算控制以及平台级项目数据库/文件存储独立只读栅栏(Read-Only Governance)。本章详细说明各项计量指标的统计口径、数据完整性状态判读、只读治理期间的读写行为边界以及超限排障方法。

截图未公开:原图可能包含账号或资源标识。

界面参考:沿用已登记的历史截图,演示数据与当前项目可能不同;本次未重新取图。

功能概述

在企业多团队共享智能体中台(如组织 Agentbase 企业智能中台 69c6d1aa00062e6bb60 下的生产项目 enterprise-ai-hub-210)的过程中,架构师、运维负责人与财务专员(Billing 角色)需要精确掌握资源消耗水位与安全保护边界:

治理与计量维度统计或控制粒度控制台查看入口超限或触发时的系统确定性行为
30 日核心用量聚合账号级 / 组织级 / 项目级(按 UTC 日聚合)账号 Usage · 组织 Usage · 项目侧栏 Metering(/usage/aggregates)只读观测大盘;当计量源延迟或检查点缺失时显式标记“不完整(Incomplete)”,绝不伪造为 0
平台 Quota 与 Ratelimit账号级 / 项目级 / IP 与会话级/console/account/quota-limits · /console/account/rate-limits超出配额或并发速率阈值时返回 HTTP 429 Too Many Requests 或对应配额超限错误码
大模型推理预算与限流LLM Gateway Key 级 / AI Gateway 项目级项目 模型 (/llm-gateway) · AI 网关 (/ai-gateway)触发 Key 月度 Token 预算或 RPM/TPM 上限时拒绝推理请求,保护上游 <DASHSCOPE_API_KEY> 账户余额
项目数据库/存储独立只读项目级双独立开关(databaseReadOnly / storageReadOnly)平台治理域(Admin Panel);项目侧体现为写入拦截响应拒绝对应域常规写入(返回 project_database_read_only / project_storage_read_only),单条/单文件立即删除例外放行

核心概念与架构

Agentbase 的计量、限流与只读保护体系贯穿于数据面请求入口与后台异步计量管线。下图展示了三级用量聚合的数据流向,以及 2.10.0 项目独立只读栅栏(Write Fence)的精细拦截逻辑:

flowchart TB
    subgraph MeteringPipeline["三级最近 30 个 UTC 日用量聚合管线"]
        RawEvents["项目实时计量源 & 检查点<br/>Storage / Bandwidth / Users / Function executions"]
        ProjUsage["1. 项目级 Metering (/usage/aggregates)<br/>含完整性校验 (Complete vs Incomplete + 缺失原因)"]
        OrgUsage["2. 组织级 Usage (/organization-{org}/usage)<br/>汇总下属项目 (**自动剔除删除态 Pending deletion 项目**)"]
        AccUsage["3. 账号级 Usage (/console/account/usage)<br/>跨组织全局汇总 + Quota / Rate limits 视图"]
        RawEvents --> ProjUsage --> OrgUsage --> AccUsage
    end

    subgraph ReadOnlyFence["2.10.0 项目数据库与存储独立只读栅栏 (HTTP / Worker / Indexer / SQL Proxy)"]
        WriteReq["收到项目数据面请求"] --> CheckType{"请求操作类型?"}
        CheckType -- "读取 / 查询 / 文件预览 / Token 读取" --> AllowRead["正常放行 (不受只读状态影响)"]
        CheckType -- "指定单文档 / 单行 / 单文件立即删除" --> AllowClean["作为紧急清理通道例外放行"]
        CheckType -- "常规新增/更新 / 批量删除 / SQL DELETE / 删库表桶" --> CheckDrain{"是否正处于只读切换<br/>写租约排空窗口?"}
        CheckDrain -- "排空超时窗口内" --> Ret503["返回 HTTP 503 Service Unavailable<br/>(调用方稍后重试)"]
        CheckDrain -- "只读已生效" --> CheckDomain{"所属资源域只读开关开启?"}
        CheckDomain -- "数据库域 databaseReadOnly=true" --> ErrDB["拒绝并返回 403<br/>project_database_read_only"]
        CheckDomain -- "存储域 storageReadOnly=true" --> ErrStg["拒绝并返回 403<br/>project_storage_read_only"]
    end

1. 最近 30 个 UTC 日四项核心计量指标定义

在账号、组织与项目的 Metering / Usage 页面(如图 1 所示),系统固定以 当前 UTC 日向前推算共 30 个 UTC 自然日 为时间窗口,统一展示以下四项核心计量:

计量指标名称英文标识统计口径与覆盖范围关联深入监控页
存储空间Storage项目内存储桶文件、构建产物及相关持久化资产占用的存储字节总量与按日变化趋势项目 Storage → Usage(/storage/usage)
网络带宽Bandwidth统计周期内经由项目端点产生的入站与出站网络传输流量总和项目 Overview 带宽趋势图
终端用户数Users项目 Auth 模块下的注册终端用户规模及按日增长趋势项目 Auth → Usage(/auth/usage)
函数执行次数Function executions项目内所有云函数(Functions)在统计周期内触发执行的累计次数项目 Functions → Usage(含 ACS 容器组 CPU/内存/网络/磁盘监控)

2. 数据覆盖状态(Completeness)与防误导设计

在传统的监控报表中,当后台采集链路延迟或某个时间分片缺失时,往往会直接把缺失日期的数值画成 0,极易误导运维与财务人员以为当日业务停摆。Agentbase 严格区分“真实用量为 0”与“计量数据缺失/不完整”:

项目只读状态(平台治理)

该能力以实例已启用项目只读保护为前提。若部署未启用,平台管理员也不能直接切换只读状态;先确认实例能力,再按下述流程处理,不把能力关闭响应当作一次已完成的状态切换。

项目可由平台管理员置为数据库只读或文件存储只读(两个独立开关,2.10.0 起),用于维护、迁移或故障隔离。数据库只读覆盖数据库、表、向量、知识库和 SQL 写入;文件存储只读覆盖桶和文件写入。一个开关开启不会自动开启另一个,也不是把整个项目的所有配置都锁定。

对日常操作的影响

下表均以原有身份和资源权限仍满足为前提;只读状态不增加读取或删除权限。

操作对应域只读时的行为
查询已有库、表、文档、行;读取、预览或下载已有文件通常可继续;若读取需要初始化缺失结构,可能返回 403 或 503
创建、修改数据库、表、列、索引、文档或行数据库只读时拒绝
修改知识库、文档元数据、分块或索引配置数据库只读时拒绝
SQL 写入及结构变更,包括 SQL DELETE数据库只读时拒绝;已有数据的只读查询仍受原查询权限约束
创建、修改桶或上传、修改文件文件存储只读时拒绝
立即删除单个文档、单行或单文件保留清理通道;仍需原删除权限
批量删除、删除整库/表/桶按所属域拒绝,不能当作单条清理例外

通过事务暂存的删除也不是立即删除例外,提交时仍会检查写入限制。数据库只读不等于文件存储只读:例如单独开启数据库只读时,不能据此判断文件上传是否被允许,还需检查存储状态与原权限。

遇到错误时怎么办

角色、入口与关联关系

1. 各级用量、配额与专项计量的控制台入口

查看目标所属层级控制台导航位置精确路由路径最小所需角色
账号 30 日聚合用量账号级顶部 Account → Usage / Metering/console/account/usage · /console/account/metering账号本人
账号速率限制与配额上限账号级顶部 Account → Rate limits / Quota limits/console/account/rate-limits · /console/account/quota-limits账号本人(只读视图)
组织 30 日聚合用量组织级组织页签 Usage / Metering/console/organization-{organization}/usage组织任意成员(含 billing / analyst)
项目 30 日聚合用量项目级项目左侧边栏 Metering/console/project-{region}-{project}/usage/aggregates项目任意成员
云函数 ACS 容器组资源水位项目级(函数)项目 Functions → 目标函数 → Usage/console/project-{region}-{project}/functions/function-{function}/usage项目任意成员
模型网关 Key Token 用量与限额项目级(AI)项目 模型(Models) → Keys / Usage/console/project-{region}-{project}/llm-gateway/keys/{key}/usage项目任意成员
内容审核 30 日分项调用统计项目级(审核)项目 Moderation(内容审核) 首页/console/project-{region}-{project}/moderation项目任意成员

2. AI 专项计量与成本控制关联说明

除了基础的四项 BaaS 计量外,AI 与智能体模块的用量和成本控制分布在各自的领域工作台中:

功能详解与操作指南

1. 查看与判读项目最近 30 个 UTC 日用量聚合视图

2. 核查账号级配额上限(Quota Limits)与速率限制(Rate Limits)

当线上接口出现偶发限流(HTTP 429)或创建资源提示达到套餐上限时,可通过以下步骤核查当前账号与组织适用的配额基线:

3. 项目只读状态下的应急处置与数据清理操作

若你的项目因平台迁移或存储超限被平台管理员开启了 databaseReadOnly 或 storageReadOnly,在数据管理页面执行操作时请遵循以下规程:

常见问题与排障

Q1:为什么我在当地时间凌晨刚创建的测试数据或执行的函数,在 Metering 页面里归到了“昨天”或“今天”的柱状图里?

原因与排查步骤: Agentbase 的三级 Usage / Metering 聚合视图统一采用 标准协调世界时(UTC)自然日 作为切分边界(固定展示当前 UTC 日及之前 29 个 UTC 日),而不随浏览器本地时区(如东八区 UTC+8)动态平移。北京时间 00:00 ~ 07:59 产生的用量在 UTC 口径下仍属于前一个 UTC 自然日,早上 08:00 之后产生的用量才计入新的 UTC 自然日。

Q2:在 Console 数据表或存储桶列表中勾选了 10 条记录点击批量删除,为什么报错 project_database_read_only / project_storage_read_only,但单独删 1 条却能成功?

原因与排查步骤: 这是因为该项目当前正处于平台管理员开启的数据库只读或存储只读状态。在只读保护策略下,为了防止批量误删或大规模数据破坏,一切**批量删除、SQL DELETE 语句以及整表/整库/整桶删除均按写入操作严格拦截;唯有针对单个文档、单行或单文件的立即删除**作为合规清理例外予以放行。若需执行批量删除,请先确认所选数据范围并联系平台管理员解除项目只读状态。

Q3:为什么大模型推理调用失败,但项目的平台 Quota 与 Ratelimit 都没有超限?

原因与排查步骤: 大模型推理请求同时受平台通用网关限流与模型网关(LLM Gateway / AI Gateway)专项配额的双重约束。若平台 Ratelimit 正常但推理报错,请按以下顺序检查:

相关文档