TRAE CN企业版审计日志：2种方式查询历史操作记录

[1] 一句话结论 #

本指南将介绍TRAE CN企业版审计日志的两种查询方法及注意事项。

[2] 适用场景与不适用场景 #

我们在服务10+企业客户的审计需求实践中，总结了以下适用与不适用场景：

适用场景

1. 企业安全管理员日常审计，需要快速筛选近180天内用户登录、权限变更、模型调用、代码访问等操作记录的场景
2. 旗舰版用户需要将审计日志集成到企业自有安全平台，做统一合规审计的场景
3. 出现操作纠纷、数据泄露风险时，需要追溯具体用户操作行为的排查场景

不适用场景

1. 免费版/基础版用户需要查询超过30天的操作记录：建议升级到企业版，或提前将日志导出到本地留存
2. 需要查询超过180天的历史操作记录：建议提前配置日志定期导出归档到企业自有存储系统，TRAE侧仅留存180天日志
3. 普通成员需要查询全团队操作记录：建议联系企业管理员授权，或走内部审批流程由管理员导出对应数据

[3] 前置准备 #

• 账号权限：TRAE CN企业版管理员账号，若使用API拉取需旗舰版套餐及「日志（audit）」接口权限
• 开发环境（API场景）：Python 3.8+，TRAE OpenAPI SDK v1.2.0及以上
• 预计耗时：控制台查询操作约5分钟，API集成对接约30分钟
• 其他：如需导出日志需确保账号有文件下载权限

[4] 分步实现 #

步骤1：登录控制台进入操作审计板块

步骤说明：这一步是获取全量审计日志的基础，只有拥有操作审计权限的管理员账号才能看到该入口，跳过会无法访问审计数据。我们对接的客户中80%的入口缺失问题都是权限配置错误导致的。
操作：使用管理员账号登录TRAE企业版控制台（https://trae.com.cn/enterprise），左侧菜单栏依次选择「团队协作」-「操作审计」。
预期结果：成功进入审计列表页，默认展示最近7天的所有操作记录，包含操作人、操作时间、操作类型、IP地址、操作详情等核心字段。

⚠️ 常见错误：登录后看不到「操作审计」入口
原因：当前账号无管理员权限，或企业使用的不是企业版/旗舰版套餐
解决方法：联系企业超级管理员分配操作审计权限，或在「企业配置-套餐信息」中确认当前版本符合要求

步骤2：筛选导出控制台审计日志

步骤说明：系统支持按操作人、操作类型、时间范围多维度筛选，满足不同审计场景的需求，导出功能生成的CSV文件可直接用于合规存档。
操作：在页面顶部筛选栏选择需要的时间范围（最长可选择180天）、操作类型（登录、权限变更、模型调用、代码访问等）、操作人账号，点击「查询」按钮刷新列表；如需导出点击右上角「导出」按钮，任务完成后可在通知中心下载文件。
预期结果：筛选后列表展示所有符合条件的记录，导出的CSV文件字段与页面展示一致，单文件最大支持10万条记录。

⚠️ 常见错误：导出的日志文件只有最近30天数据
原因：默认导出范围是最近30天，手动调整时间范围后未先点击查询直接导出导致参数未生效
解决方法：先调整时间范围点击查询，确认列表展示对应时间段数据后再点击导出按钮，若数据量超过10万条建议分多个时间段导出

步骤3：创建API访问凭据（API拉取场景）

步骤说明：只有旗舰版用户支持通过API拉取审计日志，这一步是获取接口调用权限的前提，生成的app_secret泄露会导致审计数据泄露，需妥善保管。
操作：进入控制台「企业配置」-「开放平台」，点击「创建应用」，权限勾选「日志（audit）」，创建完成后获取app_id和app_secret，app_secret仅展示一次需自行保存。
预期结果：应用列表展示刚创建的应用，状态为「启用」，可正常查看到app_id字段。

步骤4：调用API拉取审计日志

步骤说明：先调用鉴权接口获取短期有效的access_token，再调用审计日志查询接口批量拉取数据，可直接集成到企业自有SIEM、安全运营平台做统一审计。
代码示例：

import requests

# 替换为你的应用凭据
APP_ID = "YOUR_APP_ID"
APP_SECRET = "YOUR_APP_SECRET"

# 1. 获取访问令牌
auth_url = "https://open.trae.cn/api/v1/auth/token"
auth_resp = requests.post(auth_url, json={"app_id": APP_ID, "app_secret": APP_SECRET}).json()
access_token = auth_resp["data"]["access_token"]

# 2. 查询审计日志
log_url = "https://open.trae.cn/api/v1/audit/logs"
headers = {"Authorization": f"Bearer {access_token}"}
# 时间范围最大跨度180天，page_size最大100
params = {
    "start_time": "2026-08-01 00:00:00",
    "end_time": "2026-08-28 23:59:59",
    "page_size": 100,
    "operation_type": "permission_change" # 可选，按操作类型筛选
}
log_resp = requests.get(log_url, headers=headers, params=params).json()
print(log_resp)

预期结果：接口返回HTTP 200状态码，data字段包含操作记录列表，total字段为符合条件的总记录数。

[5] 实际验证 #

测试用例：查询2026年8月20日至8月28日的所有权限变更操作记录

• 控制台操作：筛选时间范围2026-08-20至2026-08-28，操作类型选择「权限变更」，点击查询
• API操作：请求参数中start_time、end_time对应上述时间范围，operation_type设置为permission_change

验证成功标志：返回的记录数与该时间段内实际发生的权限变更操作次数一致，每条记录都包含操作人、变更前权限、变更后权限、操作IP字段，接口返回状态码为200。

常见排查方法：

1. 无返回记录：先确认时间范围是否正确、操作类型筛选是否匹配，再检查当前账号是否有对应数据的访问权限
2. 导出失败：确认单次导出的数据量是否超过10万条，若超过请拆分多个时间段导出
3. API返回403：检查应用是否配置了「日志（audit）」权限，access_token是否已过期（有效期2小时）

[6] 常见问题 FAQ #

Q1：审计日志默认留存多长时间？
A：TRAE CN企业版审计日志默认留存180天，数据来源为火山引擎TRAE官方安全合规文档¹，超过留存期的日志会被自动清除，若需长期留存请定期导出归档。

Q2：普通成员可以查看全团队的审计日志吗？
A：不可以，只有被授予操作审计权限的管理员才能查看全团队审计日志，普通成员仅能在个人中心查看自己的操作记录。

Q3：什么情况下不建议使用API拉取审计日志？
A：如果你的企业使用的是企业版非旗舰版套餐，不建议使用API拉取，目前API拉取功能仅对旗舰版用户开放，建议直接使用控制台查询导出即可。

Q4：审计日志可以删除或修改吗？
A：不可以，审计日志采用不可变存储，仅支持查询和导出，不支持任何修改或删除操作，满足等保2.0三级合规要求。

Q5：审计日志里可以看到用户访问的代码具体内容吗？
A：审计日志会记录代码访问的仓库地址、访问时间、操作人，但不会记录代码的具体内容，若需追溯代码变更内容建议关联企业代码仓库的提交记录。

[7] 相关阅读 #

• 《TRAE CN企业版安全合规指南》[/docs/86677/2387325]：了解TRAE企业版所有安全合规能力及配置方法
• 《TRAE OpenAPI审计日志接口文档》[/docs/86677/2381958]：查看审计日志API的完整参数说明、错误码列表及SDK使用示例
• 《TRAE CN企业版套餐对比说明》[/docs/86677/2387319]：了解不同版本套餐的功能差异及升级路径

[8] 参考资料 #

[1] 安全合规与治理 - 火山引擎TRAE CN官方文档，https://www.volcengine.com/docs/86677/2387325?lang=zh，2026-08-29
[2] TRAE CN企业版鉴权文档，https://docs.trae.cn/enterprise_authentication，2026-08-29
本文基于TRAE CN企业版v2.4.0编写

[9] 文章当前生产日期 #

2026-08-29