文档中心

大模型应用防火墙

日志详情

查看和分析日志

日志功能支持为大模型应用防火墙上已添加的防护资源采集访问日志数据，并基于火山引擎日志服务提供检索分析、监控告警、数据可视化等功能，帮助您快速了解大模型业务的状态和防护效果，以便及时处理异常。

注意事项

开通日志服务时将自动创建服务关联角色，该角色拥有日志项目创建/回收及日志采集权限，在使用日志服务期间，请不要删除该授权，否则会影响到日志的采集及实例回收等操作。

前提条件

创建实例时已启用日志服务功能，创建相关操作可参考创建大模型应用防火墙实例。

您已完成资产接入，相关操作可参考资产接入方式说明。

配置敏感数据脱敏存储

为避免银行卡号、电子邮箱、身份证号、电话号码等敏感信息以明文形式存储在日志中，您可以开启敏感数据存储。开启后，对应资源账号的 TLS 配置会对命中敏感信息防护的日志内容进行脱敏后再存储。

登录大模型应用防火墙控制台。

在左侧导航选择日志详情。

单击右上角日志配置。

开启敏感数据存储开关。

开启后，仅命中敏感数据防护策略且执行动作为脱敏的新日志会先脱敏再存储，并在攻击日志和日志详情中以掩码形式展示敏感内容。执行动作为放行、观察、拦截、安全代答等其他动作时，日志仍按原始内容存储；页面展示方式取决于实例类型和当前查看授权。

说明

该配置用于控制日志存储方式，不会改变敏感数据防护策略的检测结果和执行动作。

敏感数据说明

日志可能包含请求正文、UserCustomInfo 等用户自定义信息和安全代答内容。请仅向必要人员授予日志查看和下载权限，分享检索结果、截图或导出文件前请再次检查并脱敏。

查看日志项目和主题

登录大模型应用防火墙控制台。

在顶栏选择实例所属地域。

在左侧导航选择日志详情。

鼠标悬浮于日志管理旁边的详情，可查看日志项目和日志主题信息。

资源类型	说明
日志项目	大模型应用防火墙自动创建的日志项目是基础的资源管理单位，且大模型应用防火墙日志项目不支持删除。单击日志项目名称可以跳转到日志服务控制台查看项目信息。
日志主题	大模型应用防火墙日志项目下默认创建专用日志主题，日志主题是进行日志管理的基本单位。例如日志采集、存储和查询分析等等。日志主题不支持通过 API、SDK 等方式写入除大模型应用防火墙日志外的其他类型数据，且不支持删除。单击日志主题名称可以跳转到日志服务控制台查看相关信息。

检索分析日志

登录大模型应用防火墙控制台。

在顶栏选择实例所属地域。

在左侧导航选择日志详情。

在检索分析语句输入框内，输入对应语句。

如何通过检索条件筛选出符合条件的日志，可参考火山引擎日志服务检索功能说明，详见检索语法。

如何通过 SQL 语句进行日志统计分析，可参考火山引擎日志服务分析功能说明，请参见分析概述。

关于日志字段的详细说明，请参见日志字段说明。

说明

多个检索语句间用空格分隔时，表示“或”逻辑，即等同于OR。例如warning error等同于warning OR error，表示检索内容中包含关键词warning或error的日志。

单击检索分析。

下方会显示查询结果图表。

（可选）设置查询图表时间范围和自动刷新。

时间范围：默认展示近 3 天内的查询结果，支持自定义相对时间和绝对时间。

自动刷新：自动刷新默认关闭，开启后可设置自动刷新频率。

查询与分析结果说明

原始日志

您可在原始日志页签下，查看查询的日志结果，并根据需要查看视图效果。默认按原始视图展示查询到的所有日志信息。

原始日志页面相关的操作说明。

图标号	功能	说明
①	显示所有字段	开启后，展示查询结果中的所有字段。
②	切换日志视图	原始：日志内容的字段集中展示，该视图下可设置内容按字段换行、平铺 JSON 类字段和紧凑型布局。表格：日志按表格样式，不同字段分列展示。
③	调整原始日志视图	原始视图支持调整显示效果。换行：开启后，日志内容的字段将分行显示。过滤与预置字段：开启后，不展示部分预置字段，具体涉及的字段以界面提示信息为准。紧凑布局：开启后，日志时间和内容将合并显示，不再分列。更多配置：过滤空字段使用分页器翻页强制解析 JSON 字段
④	搜索字段	输入字段名称，可以检索对应字段。
⑤	设置显示字段	在隐藏字段列表中选择目标字段，单击⑤所示图标，可将该字段添加至显示字段列表中，右侧日志内容视图将展示选中的字段内容。
⑥	调整字段显示顺序	鼠标按住⑥所示图标上下拖动字段，可调整字段显示顺序。
⑥		查看字段分布占比	单击⑥所示图标，可查看该字段查询结果最多的前五个值，单击在图表中查看字段分布可前往图表分析页面查看该字段查询值的数据信息。

字段名称左侧的标签为字段数据类型说明。

d：double类型，指浮点型数据类型的字段。

l：long类型，指整数类型的字段。

j：json类型，适用于格式为 JSON 对象的字段。

t：text类型，适用于字符串类型的字段。

关于日志字段数据类型的详细说明，请参见索引数据类型。

图表分析

您可在图表分析页签下，按需选择合适的图表查看分析结果。支持按表格、折线图、柱状图、饼图和单值图样式展示。更多关于图表说明和配置的信息，请参见统计图表说明。

日志保存与可见性说明

文本正文大小：单条文本日志的正文最多保存 5 MiB。超过 5 MiB 的部分不会写入日志。该上限仅用于日志写入，检测流程不以该日志保存上限截断送检正文。排查超长请求时，请结合业务侧原始请求记录，不要仅依赖日志正文还原完整内容。

安全代答日志：安全代答日志异步写入，与检测日志分开记录。检测完成后，代答日志可能短暂不可见，请稍后刷新并使用相同的 MsgID 关联查询。

根据降级原因排障

请求发生降级时，各 Content 元素中的 DegradeReason 会返回降级原因说明。

原因类别	原始原因示例	排障建议
请求参数错误	USER-InvalidMessage、内容为空	检查 Message、Role、Content、MultiPart 和 ToolCall 的结构及必填字段。高危操作防护送检 Tool Call 时，Role 应为 assistant。
账号或资产校验错误	USER-AppNotProtected、USER-AccountIDNotFound、SYS-AppNotMatch	核对请求账号、Scene 对应的 AppID、资产所属实例和接入方式；确认资产已接入当前实例且已启用防护。
实例或资产配置错误	SYS-InstanceNotActive、SYS-CheckTradeTypeNotSupport、SYS-ContentTypeDisable_*	确认实例处于运行状态，并检查资产是否启用了本次送检内容类型及相应防护能力。
请求频率超限	SYS-QPSLimit、QpsLimit	检查请求峰值、并发量和各内容类型的 QPS 配额，采用指数退避并加入随机抖动后重试，或降低并发。持续触发时评估实例规格。
检测超时或取消	SYS-TimeoutOrCancel、SYS-NotEnoughRemainingTime、context deadline exceeded	检查内容大小、客户端超时、请求是否被主动取消及检测耗时。适当延长客户端超时，或拆分过大的文档、视频和多模态请求后重试。
内容预处理错误	SYS-PreTaskAbnormal、SYS-PreTaskContentNil、SYS-PreTaskContentInvalid	检查内容是否为空、编码是否有效，以及预处理链路是否生成了可检测内容；修正请求后重试。
文件、视频或 URL 处理错误	Base64 无效、文件大小或长度超限、扩展名不支持、文件内容与扩展名不匹配、URL/证书/网络错误	按当前内容类型的使用限制检查大小、页数、时长和格式；确认 Base64 可解码、文件内容与扩展名一致，并确保 URL 可从服务端访问且证书有效。
任务调度或文件检测异常	SYS-GetImageTicketError、SYS-GetFileTicketError、SYS-FileTaskAllFailed	减小单次图片或文档规模并稍后重试。持续发生时，携带实例、时间范围、RequestID 和 TraceID 联系技术支持。
检测服务异常	SYS-ServerReturnNil、SYS-ServerDegraded 或下游错误信息	使用 RequestID 和 TraceID 关联同一请求并确认异常是否持续发生；流式请求还需检查是否提前结束或取消。持续异常时联系技术支持。
安全代答生成异常	SYS-GenerateExcept，可能与 SYS-QPSLimit 同时出现	确认请求设置了有效 MsgID，检查代答调用频率和超时设置。检测决策与代答生成结果需要分别判断；代答内容为空时不要直接使用。
其他	未识别的原始错误文本	查看同一时间窗口内的原始 Content[].DegradeReason 和上下游日志；如无法定位，请提供实例、时间范围、RequestID 和 TraceID 联系技术支持。

上表为常见降级说明的排障归纳，不是 DegradeReasonShow 或 Content[].DegradeReason 的固定枚举。实际返回内容以日志为准。

最近更新时间：2026.10.22 21:32:35

这个页面对您有帮助吗？

有用

无用