提到AI网关的功能大家最先想到的往往是模型接入、成本管控、安全防护这些。调用审计容易被忽略觉得不就是记个日志吗有什么好讲的。真正用起来才知道调用审计是很多工作的基础。出了问题要查日志合规检查要出审计报告安全事件要追溯操作性能问题要看调用链路。没有完整的审计日志这些事都干不了。这篇把MAI Gateway v1.2.0的调用审计功能拆开来讲。日志审计菜单下有三个子项操作日志、API请求日志、日志审计白名单。每个子项能做什么、怎么用、解决什么问题逐一说明。魔芋AI大模型网关I全球大模型一站式调用及服务平台魔芋AI大模型聚合平台大模型网关平台专注于提供高效能、低成本的多品类 AI 模型服务助力开发者和企业聚焦产品创新。https://www.moyu.cn/register?affXVPz一、操作日志操作日志记录的是网后台的管理操作。谁登录了、谁改了配置、谁加了模型、谁删了令牌这些操作都会被记下来。打开操作日志页面最上面是四个统计卡片。今日操作数、活跃用户数、敏感操作数、异常操作数。今日操作数是当天所有管理操作的总数。这个数能反映后台的活跃度。突然变多或者变少都可能有问题。比如突然涨了很多可能是有人在批量改配置。突然变成零了可能是日志采集出问题了。活跃用户数是当天有操作的管理员数量。这个数用来判断有没有异常登录。比如平时只有三个人管后台某天突然出现第五个活跃用户就得查一下是不是有人越权登录了。敏感操作数是涉及权限、令牌、安全策略这类关键配置的操作数量。敏感操作风险高所以单独统计。日常这个数应该比较小突然变多就要警惕。异常操作数是操作失败的次数。正常情况下应该是零或者接近零。如果异常操作数突然升高可能是系统出问题了也可能是有人在尝试越权操作。四个卡片相当于四个指示灯。日常运维不用逐条翻日志扫一眼这四个数就行。数字正常就不用管哪项异常了再往下查。二、操作日志的记录细节统计卡片下面是操作记录表。每条记录包含六个字段时间、用户、模块、操作类型、IP地址、结果。时间字段精确到秒操作发生的具体时间。查问题的时候按时间范围定位很快就能找到对应的记录。用户字段是执行这个操作的管理员账号。出了问题直接找对应的人问不用猜是谁操作的。模块字段是操作发生在哪个功能模块。比如令牌管理、模型管理、安全管理、费用中心。按模块筛选可以快速定位某个模块下的所有操作。操作类型字段用颜色区分。蓝色是新增操作橙色是修改操作。一眼就能看出来是新建了什么还是改了什么。IP地址字段是操作来源的IP。这个字段在安全排查的时候很有用。如果某个操作不是管理员本人做的看IP地址就能判断是不是账号被盗了。异地IP登录操作基本就是有问题。结果字段是操作成功还是失败。失败的操作值得重点关注。尤其是登录失败、权限验证失败这类操作失败次数多了可能是有人在暴力破解。三、操作日志的查询和导出日志量大了之后查找功能就很重要。总不能一条一条翻。操作日志支持三种搜索方式。按用户搜索查某个人的所有操作。按路径搜索查某个具体操作的记录。按错误搜索只看失败的操作。三种搜索可以组合用。除了搜索还有筛选功能。按模块筛选只看某个功能模块的操作。按操作类型筛选只看新增或者只看修改。按结果筛选只看成功或者只看失败。按日期范围筛选指定时间段。搜索和筛选组合起来定位日志的速度很快。比如想查上个月张三在安全管理模块做了哪些修改选用户选模块选操作类型选时间范围一秒出结果。导出功能也很实用。做合规报告、内部审计、安全复盘的时候需要把日志导出来。操作日志支持导出导出来之后可以做进一步分析或者存档备查。四、API请求日志API请求日志记录的是网关转发的每一次模型调用。操作日志是给管理员看的API请求日志是给开发和运维看的。v1.2.0对API请求日志的对话视图做了优化。区分了工具调用和请求参数看起来更清楚。之前的版本里工具调用的参数和正常请求的参数混在一起排查问题的时候容易搞混。现在分开了各看各的。耗时展示也改了统一用秒做单位。之前不同地方的耗时单位不一样有的是毫秒有的是秒换算起来容易出错。统一成秒之后对比起来方便很多。API请求日志的主要用途是排查问题。用户说调用失败了或者返回结果不对去请求日志里查一下看看请求参数对不对、模型返回了什么、错误信息是什么。大部分问题看一眼日志就能定位。还有一个用途是性能分析。哪个模型响应慢、哪个时间段延迟高、失败率是多少都能从请求日志里统计出来。链路监控页面的延迟和成功率数据来源就是API请求日志。五、日志审计白名单日志审计白名单是日志审计模块的第三个子项。什么是白名单呢就是有些请求或者操作不需要记日志加到白名单里网关就不记录了。为什么需要白名单。不是所有请求都有审计价值。比如健康检查的请求每分钟发一次记下来也没用还占存储空间。再比如内部系统的自动化调用量很大但都是可信的不需要逐条审计。还有一些测试环境的请求本来就是测着玩的记日志反而干扰正式数据。把这些请求加到白名单里日志里就干净了。存储压力小了查日志的时候也不会被无关数据干扰。白名单不是随便加的。加之前要想清楚这个请求真的不需要审计吗。涉及敏感数据的、涉及权限变更的、涉及费用的都不能加白名单。白名单只适合那些明确无风险、低价值、高频次的请求。白名单本身也要纳入审计。谁加了白名单、加了什么、什么时候加的这些操作本身要在操作日志里有记录。不然有人偷偷把自己的请求加了白名单审计就有漏洞了。六、调用审计的四个核心价值讲完功能说一下调用审计的实际价值。日志这东西平时好像没什么用真到要用的时候没有就是不行。第一个价值事后追溯。出了问题能查到是谁干的、什么时候干的、干了什么。配置改错了导致服务不可用查操作日志看谁改了什么配置改回去就完了。安全事件发生了查操作日志和请求日志定位攻击路径和影响范围。没有日志出了问题只能瞎猜。第二个价值合规支撑。等保、ISO27001、各类行业合规认证都要求有完整的审计日志。监管检查的时候拿不出日志就是不合规。MAI Gateway的操作日志和API请求日志支持搜索、筛选、导出做合规报告的时候直接用。第三个价值问题排查。业务方说调用有问题开发不用去业务机器上查日志直接在网关后台看请求日志就行。请求参数对不对、模型返回了什么、错误码是什么、耗时多少一目了然。排查效率高很多。第四个价值行为分析。操作日志积累多了可以分析管理员的行为模式。谁经常改配置、改哪些配置、哪个时间段操作最多。正常的操作模式有了基线异常行为就更容易发现。七、调用审计跟其他模块的联动调用审计不是孤立的模块它跟网关的其他模块是联动的。跟安全管理的联动。访问控制的策略变更、敏感词库的增删改、数据脱敏规则的调整这些操作都记在操作日志里。安全配置的每一次变更都有记录出了问题能追溯。敏感操作数这个统计卡片就是安全状态的一个指标。跟费用中心的联动。配额调整、令牌创建、模型价格变更这些跟费用相关的操作操作日志里都有记录。成本异常的时候不仅要查消费数据还要查操作日志看看是不是有人改了配额或者价格配置。跟模型管理的联动。新增模型、修改路由策略、调整权重这些操作也都有日志。模型路由出问题的时候先看操作日志有没有人改过配置再看请求日志路由是不是对的。两层排查定位更快。联动的核心是所有管理操作都留痕。不管改什么配置操作日志里都有记录。出了问题先查操作日志再查业务日志这是排查问题的标准路径。八、实际应用场景说几个调用审计的实际应用场景更直观一些。场景一配置变更导致服务异常。某天早上客服系统的AI助手突然用不了了。运维先去链路监控看发现某个模型的成功率掉下来了。再去操作日志查发现凌晨有管理员改了这个模型的路由配置。回滚配置服务恢复。整个过程十分钟搞定。要是没有操作日志得排查半天才能找到原因。场景二合规审计。公司做等保测评审计师要求提供近三个月的管理员操作日志和系统访问日志。直接从操作日志里导出指定时间段的记录交给审计师。API请求日志作为系统访问记录一并提供。不用临时凑数据直接导出就用。场景三安全事件响应。某天安全团队收到告警有个管理员账号在异地登录操作。先去操作日志查这个账号的近期操作看看改了什么配置。再去IP地址看确认是异地IP。马上禁用账号回滚所有变更然后排查入侵路径。整个响应过程的基础就是操作日志。场景四费用异常排查。某个月的AI费用突然涨了很多。先去消费明细看是哪个部门哪个项目涨的。再去成本优化看是哪个用户哪个模型耗的。然后去API请求日志查这些调用是正常业务还是异常调用。如果是正常增长就加预算。如果是应用bug导致的死循环调用就修bug。三层排查每一层都靠日志数据支撑。九、总结调用审计是AI网关里存在感不强但不可或缺的功能。平时没人天天看日志但出问题的时候第一个想到的就是查日志。MAI Gateway v1.2.0的日志审计模块三个子项各有分工。操作日志记录管理操作用来追溯和合规。API请求日志记录模型调用用来排查和分析。日志审计白名单用来过滤无价值日志让日志更干净。四个统计卡片是操作日志的亮点。今日操作数、活跃用户数、敏感操作数、异常操作数四个数把后台的运行状态浓缩在一屏里。日常看这四个数就行有异常再往下钻。做企业系统审计能力是底线。没有审计出了问题说不清合规过不了安全没保障。别看日志功能不起眼真到要用的时候才知道有多重要。