IIS Failed Request Tracing如何启用并用失败请求日志定位响应异常?

发布人:A5数据发布时间:2026-11-10 11:26阅读量:57

如果 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配图

启用站点级 Failed Request Tracing

第一步:在 IIS Manager 中打开追踪功能

  1. 打开 IIS Manager。
  2. 在左侧连接树中展开 Sites。
  3. 选中需要排查的目标站点,不要先选整个服务器。
  4. 在右侧 Actions 面板中点击 Failed Request Tracing...。
  5. 勾选 Enable。
  6. 保留默认目录,或指定一个不属于站点物理目录的自定义目录。
  7. 点击 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...,按以下方式创建第一条规则:

配置项建议值作用
ContentAll content不限制 URL 扩展名,适合初次定位
Status code(s)500-599捕获服务器端错误和网关类错误
Time taken00:00:00只按状态码触发,不增加额外耗时条件
ProviderWWW Server记录 IIS 请求管线事件
AreasRequestNotifications、Module、Authentication、Security、Filter、FastCGI 等覆盖常见处理阶段
VerbosityVerbose初次复现时获取较完整的事件细节

如果目标是分析 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-sitenameIIS 站点标识
cs-methodGET、POST 等请求方法
cs-uri-stem不含查询参数的路径
cs-uri-query查询参数
c-ip客户端 IP
sc-statusHTTP 状态码
sc-substatusIIS 子状态码
sc-win32-statusWindows 错误状态
time-takenIIS 记录的请求处理耗时,通常以毫秒表示

例如一行日志的末尾部分可能是:

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请求完整地址或路径
verbHTTP 方法
siteId站点 ID,确认是否查错站点
appPoolId实际处理请求的应用程序池
processId处理请求的工作进程
statusCode最终响应状态
triggerStatusCode触发规则的状态码
failureReason按状态码、耗时或其他条件触发的原因
timeTakenFREB 记录的请求处理耗时字段
activityIdIIS 为该请求生成的活动标识

activityId 是关联 IIS 事件和应用日志的重要线索。如果应用程序会记录请求 ID、Trace ID 或自定义 X-Request-ID,应优先使用这些标识;W3C 访问日志默认不一定包含 FREB 的 activityId,这时需要用时间、URL、方法、站点和进程 ID 组合匹配。

按请求管线顺序查找第一个异常事件

FREB 中的事件名称会因 IIS 版本、安装组件和应用类型不同而变化,但通常可以按下面的顺序观察:

读取日志并关联时间线配图

  1. 请求开始和绑定信息;
  2. 身份认证与授权;
  3. URL 重写、请求过滤和请求映射;
  4. 静态文件或处理程序映射;
  5. RequestNotifications 和模块执行;
  6. 应用程序处理;
  7. 响应状态设置;
  8. 响应发送和连接结束。

定位时不要只看最后一条事件。最后一条事件往往只是 IIS 发现请求失败的位置,真正原因可能出现在更早的模块中。

例如:

  • 在认证或授权阶段出现拒绝,重点检查身份验证方式、授权规则和访问账户。
  • 在 URL Rewrite 或请求过滤阶段改变了路径,重点检查重写规则、请求长度和过滤设置。
  • 在 MapRequestHandler 阶段没有匹配处理程序,检查扩展名映射、处理程序映射和应用程序配置。
  • 在 ExecuteRequestHandler 阶段出现异常,重点查看应用日志、应用程序池状态和工作进程。
  • 在响应发送阶段出现连接中断,检查客户端断开、代理超时、响应大小及上游连接。
  • 出现 500.19 时,通常优先检查配置文件语法、配置节锁定和无效模块,不能只等待应用程序日志。

FREB 中的事件时间、事件顺序和模块名称比单个状态码更有价值。对于耗时问题,应找到耗时明显增加的阶段,再将该阶段与应用日志或后端服务日志对应起来。不要把 FREB 的耗时字段和 W3C 的 time-taken 直接当成同一个字段进行数值相加,两个日志的统计范围可能不同。

与应用日志和 Windows 事件日志对齐

推荐按以下顺序建立时间线:

与应用日志和 Windows 事件日志对齐配图

  1. 在 W3C 日志中找到目标 URL、方法、状态码和 time-taken。
  2. 使用该时间前后数秒范围筛选 FREB 文件。
  3. 确认 FREB 中的 siteId、appPoolId、URL 和 processId 与请求一致。
  4. 根据 activityId、应用请求 ID 或自定义关联标记查应用日志。
  5. 在 Windows Event Viewer 的 Windows Logs > Application 和 System 中检查同一时间段的应用程序池、模块、.NET Runtime、IIS-W3SVC-WP 和 WAS 事件。
  6. 若 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 存储,可用于承载企业网站、业务后台和数据库等服务;不同地区的线路与硬件组合,也能为多地业务部署提供相应资源基础。

常见失败情况与处理方式

已启用功能但没有生成文件

依次检查:

常见失败情况与处理方式配图

  1. 请求是否真的到达了目标站点;
  2. 请求是否命中了规则的状态码或耗时条件;
  3. 查看的是不是正确的 W3SVC<站点ID> 目录;
  4. 自定义目录是否存在;
  5. IIS 工作进程是否有目录写入权限;
  6. FREB 是否在站点级别启用;
  7. 配置节是否被父级锁定。

可以再次确认站点 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

相关推荐