IIS Failed Request Tracing如何启用并用失败请求日志定位响应异常?
如果 IIS 返回 500、502、404 等异常响应,而普通访问日志只能看到状态码和耗时,可以启用 Failed Request Tracing(简称 FREB)。它会针对符合条件的请求生成 XML 追踪文件,记录请求经过的模块、响应状态变化、处理阶段、应用程序池和工作进程等信息,适合定位“请求在哪个阶段失败”。
首次部署建议以 Windows Server 2016、2019 或 2022 上的 IIS 10 为例,在目标站点范围内开启追踪,而不是直接对所有站点和所有请求启用。实际定位时,应把 IIS W3C 访问日志、FREB XML、应用程序日志和 Windows 事件日志按时间、站点、URL、状态码及请求标识关联起来。
准备条件与日志范围
适用环境
本文操作适用于以下场景:
- Windows Server 已安装 IIS,且目标站点可以在 IIS Manager 中管理。
- 需要分析 500、502、503、404 等失败响应。
- 需要判断异常发生在认证、授权、URL 重写、静态文件、应用程序模块、反向代理或响应发送阶段。
- 需要分析响应耗时过长,但访问日志无法说明具体卡在哪个模块。
FREB 主要记录 IIS 请求管线和模块事件,不等同于应用程序异常日志。若应用程序抛出异常但 IIS 只返回统一的 500 页面,仍然需要结合 ASP.NET、ASP.NET Core、JavaScript 服务或其他后端程序自身的日志。
使用管理员权限准备
使用管理员 PowerShell 检查 IIS 追踪组件:
Import-Module ServerManager
Get-WindowsFeature Web-Http-Tracing
如果结果中的 Install State 不是 Installed,安装该角色服务:
Install-WindowsFeature Web-Http-Tracing
预期结果中会出现类似内容:
Success Restart Needed Exit Code Feature Result
------- -------------- --------- --------------
True No Success {Tracing}
如果系统提示需要重启,应先在维护窗口完成重启,再继续配置。已经安装该组件时,不要重复安装。
同时确认 IIS 核心服务正常运行:
Get-Service W3SVC, WAS
预期 Status 为 Running。如果 W3SVC 或 WAS 未运行,先处理 IIS 服务状态,不要直接以 FREB 日志判断请求故障。
确认站点编号和现有日志位置
FREB 日志通常按照站点编号分目录。先列出站点名称和 ID:
& "$env:windir\system32\inetsrv\appcmd.exe" list site
示例输出:
SITE "Default Web Site" (id:1,bindings:http/*:80:,state:Started)
SITE "OrderSite" (id:2,bindings:https/*:443:orders.example.test,state:Started)
也可以使用 PowerShell:
Import-Module WebAdministration
Get-Website | Select-Object Name, Id, State, PhysicalPath
IIS 默认访问日志通常位于:
C:\inetpub\logs\LogFiles\W3SVC<站点ID>\
FREB 默认目录通常为:
C:\inetpub\logs\FailedReqLogFiles\W3SVC<站点ID>\
例如站点 ID 为 2 时,应重点查看:
C:\inetpub\logs\LogFiles\W3SVC2\
C:\inetpub\logs\FailedReqLogFiles\W3SVC2\
如果使用自定义目录,目录不能放在站点可下载的静态文件目录中,避免追踪文件被通过 HTTP 直接访问。FREB 可能包含 URL、查询参数、用户名、模块信息和请求上下文,应限制访问权限。

启用站点级 Failed Request Tracing
第一步:在 IIS Manager 中打开追踪功能
- 打开 IIS Manager。
- 在左侧连接树中展开 Sites。
- 选中需要排查的目标站点,不要先选整个服务器。
- 在右侧 Actions 面板中点击 Failed Request Tracing...。
- 勾选 Enable。
- 保留默认目录,或指定一个不属于站点物理目录的自定义目录。
- 点击 OK 保存。
首次排查建议使用默认目录,减少目录权限问题。只有在磁盘空间、日志分区或权限策略有明确要求时,再改用自定义路径。
如果使用自定义目录,例如 D:\IISLogs\FailedReqLogFiles,可以先创建目录:
$frebDirectory = 'D:\IISLogs\FailedReqLogFiles'
New-Item -Path $frebDirectory -ItemType Directory -Force
然后查看现有权限:
icacls $frebDirectory
在确认应用程序池使用默认的 IIS 工作进程身份后,可以为 IIS 工作进程组授予目录修改权限:
icacls $frebDirectory /grant 'IIS_IUSRS:(OI)(CI)(M)'
该权限变更只作用于追踪目录,不要直接对磁盘根目录或整个站点目录授予修改权限。修改前可以备份 ACL:
icacls $frebDirectory /save D:\IISLogs\freb-acl-backup.txt
第二步:创建失败请求规则
在目标站点的 Failed Request Tracing Rules 中点击 Add...,按以下方式创建第一条规则:
| 配置项 | 建议值 | 作用 |
|---|---|---|
| Content | All content | 不限制 URL 扩展名,适合初次定位 |
| Status code(s) | 500-599 | 捕获服务器端错误和网关类错误 |
| Time taken | 00:00:00 | 只按状态码触发,不增加额外耗时条件 |
| Provider | WWW Server | 记录 IIS 请求管线事件 |
| Areas | RequestNotifications、Module、Authentication、Security、Filter、FastCGI 等 | 覆盖常见处理阶段 |
| Verbosity | Verbose | 初次复现时获取较完整的事件细节 |
如果目标是分析 404,应单独创建状态码为 404 的规则;如果目标是分析 200 响应但处理过慢,应创建按耗时触发的规则,不要指望 500-599 规则捕获正常状态码。
针对 ASP.NET Framework 应用,可以额外选择 ASPNET Provider;经典 ASP 应用可以选择 ASP Provider。ASP.NET Core 应用通常先保留 WWW Server Provider,并结合应用程序日志查看异常,不能仅依赖传统 ASPNET Provider。
第三步:为慢请求增加独立规则
如果问题表现为页面偶尔加载很慢但最终返回 200,可以再创建一条规则:
- Content:All content
- Status code:按照界面支持的范围选择所有相关状态码,例如
200-599 - Time taken:例如
00:00:05 - Provider:WWW Server
- Verbosity:Verbose
00:00:05 表示请求处理时间达到 5 秒后触发,具体界面格式以当前 IIS Manager 显示为准。首次配置不建议把阈值设置得过低,否则静态资源、慢客户端或大响应会产生大量文件。
第四步:使用 Appcmd 检查配置
图形界面保存后,可以用 Appcmd 检查站点配置是否生效:
$appcmd = "$env:windir\system32\inetsrv\appcmd.exe"
& $appcmd list config "OrderSite" `
/section:system.webServer/tracing/traceFailedRequestsLogging
& $appcmd list config "OrderSite" `
/section:system.webServer/tracing/traceFailedRequests
预期结果应包含:
enabled="true";- 追踪目录为预期路径;
- 至少存在一条
traceFailedRequests规则; - 规则的状态码或耗时条件与排查目标一致。
也可以在配置文件中看到类似结构,但不建议直接覆盖已有配置:
<system.webServer>
<tracing>
<traceFailedRequestsLogging
enabled="true"
directory="C:\inetpub\logs\FailedReqLogFiles" />
<traceFailedRequests>
<add path="*">
<traceAreas>
<add
provider="WWW Server"
areas="Authentication,Security,Filter,StaticFile,RequestNotifications,Module,FastCGI"
verbosity="Verbose" />
</traceAreas>
<failureDefinitions statusCodes="500-599" />
</add>
</traceFailedRequests>
</tracing>
</system.webServer>
已有 web.config、父级配置或服务器级配置时,直接粘贴片段可能造成重复节点或配置锁定错误。优先使用 IIS Manager 添加规则,并用 Appcmd 读取结果。
生成一次可控的失败请求
使用测试环境或已有测试接口
不要为了制造 500 错误而直接修改生产站点的业务代码或 web.config。优先使用:
- 已有的测试接口;
- 预发布站点;
- 能够明确返回 500 的诊断页面;
- 可控的超时测试接口。
例如,目标站点已有测试地址时,可以使用 curl.exe 发起请求,并附加一个便于检索的测试标记:
$marker = "FREB-" + (Get-Date -Format "yyyyMMdd-HHmmss")
curl.exe -k -i `
-H "X-FREB-Test: $marker" `
"https://orders.example.test/freb-test?case=500"
这里的域名和路径只是示例,不能直接当作实际可用接口。预期响应应为:
HTTP/1.1 500 Internal Server Error
如果测试接口返回 200,说明它没有触发当前 500-599 规则;如果返回 404,则需要检查是否另有 404 规则,不能据此判断 500 规则失效。
验证 FREB 文件是否生成
请求完成后,查看目标站点对应的追踪目录:
$tracePath = 'C:\inetpub\logs\FailedReqLogFiles\W3SVC2'
Get-ChildItem $tracePath |
Sort-Object LastWriteTime -Descending |
Select-Object -First 5 Name, Length, LastWriteTime
预期会出现类似文件:
Name Length LastWriteTime
---- ------ -------------
fr000001.xml 18432 2025-01-15 08:41:23
文件名和编号会随已有日志数量变化,不要固定要求必须是 fr000001.xml。重点检查:
- 文件的修改时间接近测试请求时间;
- 文件大小大于 0;
- 文件位于正确的
W3SVC<站点ID>目录; - XML 中包含目标 URL、状态码或触发原因。
如果浏览器打开 XML 后只显示原始文本,可以使用文本编辑器、XML 查看器或浏览器开发工具查看节点。不要把包含请求头、查询参数或身份信息的 FREB 文件上传到公开网站。
读取日志并关联时间线
先查 IIS W3C 访问日志
访问日志适合确认请求是否到达了目标站点,以及最终返回了什么状态。重点查看当天的:
C:\inetpub\logs\LogFiles\W3SVC<站点ID>\u_exYYMMDD.log
W3C 日志文件开头的 #Fields: 行决定字段顺序,不能只凭经验猜列。常见字段包括:
| 字段 | 关注内容 |
|---|---|
date、time | 请求发生时间 |
s-sitename | IIS 站点标识 |
cs-method | GET、POST 等请求方法 |
cs-uri-stem | 不含查询参数的路径 |
cs-uri-query | 查询参数 |
c-ip | 客户端 IP |
sc-status | HTTP 状态码 |
sc-substatus | IIS 子状态码 |
sc-win32-status | Windows 错误状态 |
time-taken | IIS 记录的请求处理耗时,通常以毫秒表示 |
例如一行日志的末尾部分可能是:
500 0 0 1842
在字段顺序确认为 sc-status sc-substatus sc-win32-status time-taken 时,可解释为:
- HTTP 状态码为 500;
- IIS 子状态码为 0;
- Windows 状态码为 0;
- 请求耗时约 1842 毫秒。
这里的 0 不代表应用没有错误,只表示该字段没有提供更具体的子状态或 Windows 错误码。
sc-substatus 有助于区分不同类型的 IIS 错误,例如 404.2、403.14、500.19 等。sc-win32-status 如果是非零值,可以进一步使用 Windows 命令查询错误描述:
net helpmsg 64
命令中的数字应替换为日志里的实际错误码。具体含义仍需结合请求阶段和其他日志判断,不能只根据一个数字下结论。
再看 FREB XML 的请求摘要
FREB 文件顶部或摘要节点通常包含以下信息:
| 字段 | 定位价值 |
|---|---|
url | 请求完整地址或路径 |
verb | HTTP 方法 |
siteId | 站点 ID,确认是否查错站点 |
appPoolId | 实际处理请求的应用程序池 |
processId | 处理请求的工作进程 |
statusCode | 最终响应状态 |
triggerStatusCode | 触发规则的状态码 |
failureReason | 按状态码、耗时或其他条件触发的原因 |
timeTaken | FREB 记录的请求处理耗时字段 |
activityId | IIS 为该请求生成的活动标识 |
activityId 是关联 IIS 事件和应用日志的重要线索。如果应用程序会记录请求 ID、Trace ID 或自定义 X-Request-ID,应优先使用这些标识;W3C 访问日志默认不一定包含 FREB 的 activityId,这时需要用时间、URL、方法、站点和进程 ID 组合匹配。
按请求管线顺序查找第一个异常事件
FREB 中的事件名称会因 IIS 版本、安装组件和应用类型不同而变化,但通常可以按下面的顺序观察:

- 请求开始和绑定信息;
- 身份认证与授权;
- URL 重写、请求过滤和请求映射;
- 静态文件或处理程序映射;
RequestNotifications和模块执行;- 应用程序处理;
- 响应状态设置;
- 响应发送和连接结束。
定位时不要只看最后一条事件。最后一条事件往往只是 IIS 发现请求失败的位置,真正原因可能出现在更早的模块中。
例如:
- 在认证或授权阶段出现拒绝,重点检查身份验证方式、授权规则和访问账户。
- 在 URL Rewrite 或请求过滤阶段改变了路径,重点检查重写规则、请求长度和过滤设置。
- 在
MapRequestHandler阶段没有匹配处理程序,检查扩展名映射、处理程序映射和应用程序配置。 - 在
ExecuteRequestHandler阶段出现异常,重点查看应用日志、应用程序池状态和工作进程。 - 在响应发送阶段出现连接中断,检查客户端断开、代理超时、响应大小及上游连接。
- 出现 500.19 时,通常优先检查配置文件语法、配置节锁定和无效模块,不能只等待应用程序日志。
FREB 中的事件时间、事件顺序和模块名称比单个状态码更有价值。对于耗时问题,应找到耗时明显增加的阶段,再将该阶段与应用日志或后端服务日志对应起来。不要把 FREB 的耗时字段和 W3C 的 time-taken 直接当成同一个字段进行数值相加,两个日志的统计范围可能不同。
与应用日志和 Windows 事件日志对齐
推荐按以下顺序建立时间线:

- 在 W3C 日志中找到目标 URL、方法、状态码和
time-taken。 - 使用该时间前后数秒范围筛选 FREB 文件。
- 确认 FREB 中的
siteId、appPoolId、URL 和processId与请求一致。 - 根据
activityId、应用请求 ID 或自定义关联标记查应用日志。 - 在 Windows Event Viewer 的 Windows Logs > Application 和 System 中检查同一时间段的应用程序池、模块、.NET Runtime、IIS-W3SVC-WP 和 WAS 事件。
- 若 IIS 日志中没有对应请求,再查看 HTTPERR 日志或负载均衡器、CDN、上游代理日志。
HTTP.sys 层面的日志通常位于:
C:\Windows\System32\LogFiles\HTTPERR\
如果请求在 HTTP.sys 阶段被拒绝、队列溢出、连接过早关闭或没有匹配到 IIS 处理链,可能只有 HTTPERR 或前置设备日志,FREB 不一定能生成文件。
注意时区问题:
- IIS W3C 日志通常使用 UTC 时间;
- Windows 事件查看器通常按服务器本地时间显示;
- 应用日志可能使用本地时间、UTC 或容器时间。
关联前先确认服务器时区和各日志的时间格式,必要时将时间统一换算到 UTC。
IIS 请求追踪与应用、系统日志共同构成了服务器运维中的问题定位线索。A5idc数据提供香港、美国、日本等地区的物理服务器租用,配置覆盖 Xeon Gold、AMD EPYC 平台及 SSD、NVMe 存储,可用于承载企业网站、业务后台和数据库等服务;不同地区的线路与硬件组合,也能为多地业务部署提供相应资源基础。
常见失败情况与处理方式
已启用功能但没有生成文件
依次检查:

- 请求是否真的到达了目标站点;
- 请求是否命中了规则的状态码或耗时条件;
- 查看的是不是正确的
W3SVC<站点ID>目录; - 自定义目录是否存在;
- IIS 工作进程是否有目录写入权限;
- FREB 是否在站点级别启用;
- 配置节是否被父级锁定。
可以再次确认站点 ID 和配置:
& "$env:windir\system32\inetsrv\appcmd.exe" list site
& "$env:windir\system32\inetsrv\appcmd.exe" list config "OrderSite" `
/section:system.webServer/tracing/traceFailedRequestsLogging
如果访问日志中完全没有该请求,先检查 DNS、绑定、端口、负载均衡转发和 HTTPERR,不要继续调整 FREB 规则。
提示配置节不能在当前路径使用
如果 IIS Manager 或 Appcmd 报告配置节被锁定,说明当前站点级别不允许修改该配置。不要为了快速解决而直接对生产服务器执行全局解锁。应先确认:
- 变更是否允许在服务器级别进行;
- 是否有其他站点依赖当前配置;
- 是否已备份 IIS 配置;
- 是否需要由服务器管理员统一调整。
全局解锁可能改变其他站点的配置继承行为,影响范围不只限于当前站点。
生成文件但内容不完整
FREB 记录的是 IIS 请求管线,不会自动替代应用程序的堆栈日志。常见原因包括:
- 异常由应用内部捕获并转换为统一错误页面;
- 应用在独立进程中运行,详细异常只写入应用日志;
- ASP.NET Core 的异常发生在 IIS 模块之外;
- 上游服务连接失败,但错误原因只记录在反向代理或应用日志;
- 追踪规则只启用了 WWW Server,没有启用相关 Provider。
此时应保留 FREB 作为请求阶段证据,再查看应用程序日志、进程标准输出日志或后端服务日志。
日志数量快速增加
FREB 的 Verbose 级别会显著增加单请求文件大小。排查完成后应立即:
- 关闭站点追踪;
- 删除或停用不再需要的规则;
- 将已有日志归档到受控位置;
- 检查磁盘剩余空间;
- 限制追踪时间和请求范围。
如果需要长期观察慢请求,应提高耗时阈值,并尽量将规则限制到具体路径,而不是对所有请求使用 path="*"。
结果检查
一次有效的 FREB 定位应至少形成下面的证据链:
- W3C 日志确认请求时间、方法、路径、状态码、子状态码和耗时。
- FREB XML 确认目标站点、应用程序池、工作进程和触发原因。
- FREB 事件时间线指出第一个异常模块或处理阶段。
- 应用日志或 Windows 事件日志提供异常堆栈、进程错误或上游连接信息。
- 多份日志的时间已经统一到同一时区。
- 测试请求生成了预期数量的追踪文件,正常请求不会无限生成文件。
- 追踪目录不在站点可访问目录内,权限范围符合最小化要求。
- 500、502、503、404 和慢请求分别使用匹配的规则,没有用一条过宽规则覆盖所有场景。
如果日志只显示 500,而没有显示应用异常,下一步不是盲目提高 FREB 级别,而是根据最后一个正常事件判断请求是否已经进入应用。请求未进入应用时,优先检查 IIS 配置、处理程序映射、应用程序池和模块;请求已经进入应用时,优先查看应用自身日志和依赖服务。
回滚与验收检查项
完成定位并归档必要证据后,可以通过 IIS Manager 关闭目标站点的 Failed Request Tracing。也可以使用 Appcmd:
$appcmd = "$env:windir\system32\inetsrv\appcmd.exe"
& $appcmd set config "OrderSite" `
/section:system.webServer/tracing/traceFailedRequestsLogging `
/enabled:false
关闭日志记录不会自动删除已经生成的 XML 文件。涉及清理时,应先确认文件已归档、没有审计或故障复盘要求,再按组织的日志保留策略处理。不要在未备份的情况下直接批量删除追踪文件。
如果配置前做过 IIS 配置备份,可以查看备份列表:
& "$env:windir\system32\inetsrv\appcmd.exe" list backup
恢复整个 IIS 配置备份会影响服务器上的其他站点,不应作为普通回滚动作直接执行。优先在 IIS Manager 中删除本次新增规则、关闭追踪,并保留其他站点原有配置。
最终验收可以按以下清单执行:
- [ ]
Web-Http-Tracing已安装。 - [ ] 目标站点的追踪功能已启用并指向正确目录。
- [ ] 规则状态码或耗时条件与故障现象匹配。
- [ ] 测试请求产生了可读取的 FREB XML。
- [ ] FREB 中的站点 ID、应用程序池和 URL 与目标请求一致。
- [ ] W3C、FREB、应用日志和事件日志可以按时间线互相印证。
- [ ] 追踪目录权限和访问路径已检查。
- [ ] 故障排查结束后已关闭追踪或缩小采集范围。
- [ ] 需要保留的日志已归档,回滚后未产生新的无关追踪文件。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/8580.html



