TRAE CN企业版审计日志：全量收集配置实战教程

[1] 一句话结论 #

本指南将带你完成TRAE CN企业版审计日志的全量收集配置，满足等保合规要求。

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

适用场景

1. 等保2.0三级及以上合规要求，需要留存全量用户操作、模型调用日志至少180天的企业级场景
2. 日均TRAE调用量1万次以上，需要统一纳管审计日志、做操作溯源的中大型团队
3. 需要对接企业自有SOC平台、集中分析异常操作的安全运维场景

不适用场景

1. 个人开发者使用TRAE免费版/基础版场景，建议直接使用控制台自带的个人操作记录功能
2. 仅需要简单查看单会话操作记录的场景，不需要配置全量收集，直接在会话详情页查看即可
3. 日志留存要求超过365天的场景，建议搭配火山引擎对象存储TOS做日志冷备，不要仅依赖TRAE自带存储

[3] 前置准备 #

• 账号：TRAE CN企业版管理员账号，旗舰版需额外开放开放平台权限
• 环境：Python 3.9+，如需对接日志服务需提前开通火山引擎日志服务（SLS）v2.0版本
• SDK：trae-python-sdk v1.3.2及以上版本
• 预计耗时：30分钟

[4] 分步实现 #

步骤1：开启控制台审计日志总开关

步骤说明：首先要在企业配置里开启审计日志功能，开启后才会自动记录所有操作，关闭会停止日志写入，历史日志不会删除。
操作：登录TRAE CN企业版控制台，进入「企业配置」-「审计与日志」模块，点击「开启审计日志」按钮，勾选需要记录的日志类型（用户登录、权限变更、模型调用、代码访问、配置修改）。
预期结果：开关显示为已开启，页面会显示最近1小时的最新审计日志条目。

⚠️ 常见错误：开启后看不到新产生的日志
原因：默认开启后有最多5分钟的延迟，部分用户会误以为配置失败
解决方法：等待5分钟后刷新页面，若仍无日志可提交工单联系技术支持确认实例状态。

步骤2：生成日志拉取API凭据（仅旗舰版）

步骤说明：如果需要把日志同步到自有系统，需要申请带审计日志权限的API凭据，普通凭据没有日志拉取权限，跳过这一步无法调用日志接口。
操作：进入「企业配置」-「开放平台」-「应用凭据」，点击「创建应用」，填写应用名称后勾选「日志（audit）」权限，点击确认后保存生成的app_id和app_secret。
代码样例：

import requests
# 替换为你的app_id和app_secret
APP_ID = "YOUR_APP_ID"
APP_SECRET = "YOUR_APP_SECRET"
url = "https://api.trae.cn/openapi/v1/auth/token"
payload = {"app_id": APP_ID, "app_secret": APP_SECRET}
resp = requests.post(url, json=payload)
access_token = resp.json()["data"]["access_token"]
print(access_token)

预期结果：成功获取有效期2小时的access_token，返回码为200。

⚠️ 常见错误：调用鉴权接口返回403权限不足
原因：创建应用时没有勾选「日志（audit）」权限，或者使用了普通用户的凭据
解决方法：回到应用凭据页面确认权限配置，使用企业管理员账号创建的凭据。

步骤3：调用审计日志接口拉取全量日志

步骤说明：通过OpenAPI可以拉取指定时间范围内的所有审计日志，单页最大返回1000条，分页拉取即可获取全量数据。根据火山引擎TRAE官方文档数据，日志写入延迟平均为2.3分钟，p99延迟不超过5分钟。
代码样例：

url = "https://api.trae.cn/openapi/v1/audit/logs"
headers = {"Authorization": f"Bearer {access_token}"}
params = {
    "start_time": "2026-08-01 00:00:00",
    "end_time": "2026-08-29 00:00:00",
    "page_size": 1000,
    "page_num": 1
}
resp = requests.get(url, headers=headers, params=params)
logs = resp.json()["data"]["list"]
# 日志字段说明：user_id（操作用户ID）、action（操作类型）、timestamp（操作时间）、detail（操作详情）、ip（操作IP）

预期结果：返回对应时间范围内的审计日志列表，结构与字段说明完全匹配。

步骤4：对接火山引擎日志服务（可选）

步骤说明：如果需要做日志的长期存储、异常告警、关联分析，可以把日志同步到火山引擎日志服务。
操作：在部署TRAE代理的服务器上安装日志采集插件，配置上报地址为你的火山引擎日志服务Project地址，填入AK/SK即可自动上报。
预期结果：10分钟后可以在火山引擎日志服务控制台看到上报的TRAE审计日志数据。

[5] 实际验证 #

测试用例：使用普通用户账号登录TRAE控制台，修改个人密码，然后拉取最近10分钟的审计日志。
输入：调用审计日志接口，start_time设置为10分钟前的时间，end_time设置为当前时间，过滤action为"user_modify_password"。
预期输出：返回一条日志记录，user_id为该用户的ID，detail字段包含修改密码的操作记录，HTTP状态码为200。
验证成功标志：日志记录与实际操作完全匹配，无遗漏。
验证失败排查：

1. 没有找到对应日志：先确认审计日志总开关是否开启，等待5分钟后再重试
2. 接口返回401：确认access_token是否过期，重新调用鉴权接口获取新的token
3. 日志字段缺失：确认使用的是v1版本的API，v0版本的接口返回字段不完整

[6] 常见问题 FAQ #

Q1：审计日志默认留存多久，能不能延长？
A1：默认留存180天，旗舰版最多支持自定义留存365天，超过365天的日志需要自行导出到对象存储留存。

Q2：什么情况下不建议使用OpenAPI拉取日志？
A2：如果你的日志查询频率超过1次/分钟，或者拉取时间范围超过30天，建议直接使用控制台导出功能，频繁调用OpenAPI会触发限流。

Q3：我可以跳过API凭据配置步骤，直接导出日志吗？
A3：可以，如果你不需要对接自有系统，直接在控制台「审计与日志」页面点击导出按钮即可下载CSV格式的日志文件，不需要配置API。

Q4：审计日志可以删除吗？
A4：不支持手动删除审计日志，日志到期后会自动销毁，满足合规要求。

Q5：审计日志会记录模型调用的prompt和返回内容吗？
A5：默认不会记录，如果你需要记录内容，需要在审计日志配置里开启「内容审计」开关，开启后会额外存储调用的上下文内容，存储成本会增加约30%。

[7] 相关阅读 #

• 《TRAE CN企业版安全合规白皮书》[/docs/86677/2387325]，了解TRAE的等保合规能力
• 《火山引擎日志服务对接指南》[/docs/6470/2598423]，学习如何把TRAE日志接入统一观测平台
• 《TRAE OpenAPI参考文档》[/docs/86677/2381949]，查看完整的审计日志接口参数说明

[8] 参考资料 #

[1] TRAE CN官方文档 审计日志功能介绍，https://docs.volcengine.com/docs/86677/2387325，2026-08-29
[2] TRAE CN OpenAPI参考，https://docs.volcengine.com/docs/86677/2381949，2026-08-29
本文基于TRAE CN企业版v2.1.0版本编写

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

2026-08-29