如何启用Salesforce免费API Total Usage EventLogFile排查废弃API

一、启用ApiTotalUsage事件日志的步骤 #

• 进入Salesforce Setup界面，搜索Event Log Files（事件日志文件）
• 在事件类型列表中找到ApiTotalUsage选项，勾选启用
• 设置日志保留时长（建议至少保留30天，满足排查周期需求）
• 保存设置，系统会在24小时内开始生成对应日志文件

二、分析ApiTotalUsage日志定位问题 #

• 返回Event Log Files页面，点击Download下载最新的ApiTotalUsage日志（格式为CSV）
• 用表格工具（如Excel、Google Sheets）打开日志，重点筛选以下字段：
  • ApiVersion：筛选值为21.0至30.0的记录，这些就是待修复的旧版API调用
  • ClientId：对应发起调用的应用客户端ID，可关联到具体集成应用
  • Username：发起API调用的用户账号，便于定位内部调用来源
  • NumberOfRequests：统计该版本API的调用频次，优先处理高频调用
• 若无法通过ClientId识别应用，可在Setup中搜索Connected Apps，通过客户端ID匹配到对应应用详情

三、补充排查手段 #

• 检查Apex代码：搜索所有包含ApiVersion声明的类、触发器或匿名代码块，确认是否存在硬编码的21.0-30.0版本调用
• 查看Connected Apps配置：每个Connected App的设置页面可查看其默认使用的API版本，直接排查是否使用了弃用版本
• 对接第三方开发者：若调用来自外部集成应用，直接确认其API版本，要求升级至31.0及以上受支持版本

注意：ApiTotalUsage日志存在生成延迟，启用后需等待1-24小时才能获取到数据；若日志未找到目标记录，可结合Login History和Setup Audit Trail辅助排查异常调用来源

内容的提问来源于stack exchange，提问作者Abin