Table of Contents

如何在 web role 中抓取 IIS dump 文件

Azure 云服务中的 role 可以理解为一种部署方式，而我们要运行的程序，都是要运行在进程上的。 Azure 云服务中有两种 role，分别是 web role 和 worker role，这两种 role 的主要区别在于，web role 上的项目是被部署在 IIS 服务上，而 worker role 上的项目被部署在独立的进程上。因此，我们一般都使用 web role 来部署一些对外公开访问的网站或者服务。

我们在使用 web role 部署对外公开的应用时，尤其是一些网站，在某些情况下会遇到网站服务不可用的情况，此时如果排除了 Azure 平台的问题，我们需要查看在问题期间 IIS 服务是不是存在什么问题。这篇文章就是主要介绍当您是使用 web role full IIS 服务时，我们发现 web role 不可用并且非 Azure 平台问题时，应该如何收集 dump 文件来分析 IIS 出现了什么问题。

问题症状：

当您排除 Azure 平台问题后，发现您的服务还是有问题，这个时候，您可以 RDP 到您的 web role 中，查看路径 C:\Resources\Directory{DeploymentID}.{Rolename}.DiagnosticStore\LogFiles\Web 下的 IIS 日志，看看是否有任何的线索：

如果您 IIS 日志在问题期间返回 200，则证明 IIS 可以正常处理请求，如：

2016-6-31 22:14:00 W3SVC1273337584 RD77890D5837721 xx.xxx.xxx.x POST  
/Api/Aggregator/MemberInfoQuery - 80 - xx.xxx.xxx.xxx HTTP/1.1 - - -   
yourcloudservicename.chinacloudapp.cn 200 0 0 1574 453 140

如果您的 IIS 日志在问题期间返回 503 或者 404，则说明您的 IIS server 无法正常成功处理请求，比如 503.2，它表示您当前时间的并发请求超过了限定数，也就是您的 web 应用因为某些原因对外面的请求处理不过来，至于为什么我们就必须通过生成 dump 文件来分析。

2016-6-31 01:52:25 W3SVC1273337584 RD77890D5837721 xx.xxx.xxx.x POST  
/Api/Aggregator/LogisticCodeQuery - 80 - xx.xxx.xxx.xxx HTTP/1.0 - - -  
yourcloudservicename.chinacloudapp.cn 503 2 0 214 354 106

RDP 到 role 上抓取 dump 文件：

如果当您查看 IIS 日志，发现 IIS 返回是不正常的情况(404/503…)并且该问题还持续发生，您可以通过 RDP 到对应的 role 上抓取 dump 来分析 IIS 进程( w3wp.exe )是否存在 hang 住或者其他逻辑问题，具体方法如下：

  1. 请配置好您 web role RDP, 并登录到相应的 role 上。
  2. 打开您的 task manager -> details ->找到 w3wp.exe 并选中。
  3. 右键选择 create dump file，在发生问题期间每隔 3 分钟抓取一次 dump 文件并保存，抓取 3-5 次，生成 dump 文件后进行分析。

通过 IIS 做配置生成自定义 dump 文件：

我们简单介绍当问题持续发生时如何抓取 dump 的方法，但是我们经常遇到一些问题只是间断性发生，或者发生时间短暂手动抓取 dump 可能来不及，这种情况下，我们可以通过 IIS 提前做好配置，使得 IIS 在某些特定的触发条件下通过 procdump 为我们自动抓取 dump，具体方法如下：

  1. 从链接下载 procdump.exe 和 procdump64.exe，放在某个目录下（生成 dump 的位置跟该目录是一致的），这里我们以 C:\dump\IISdump 为例。

  2. 打开 web.config, 可以将以下高亮部分 <traceFailedRequests> 粘贴到您的 web.config 里的 <system.webServer> 内。 <traceFailedRequests> 是用来定义一个 web 请求到 IIS server 如果超时、失败（404/500）时记录相应的状态，详细的使用方法您可以参考链接。下面我们以一个请求响应超过 40s 则生成 dump 为例。

    <configuration>
<system.webServer>

<tracing>
  <traceFailedRequests>
    <remove path="*" />
    <add path="*" customActionExe="C:\dump\IISdump\procdump.exe" customActionParams="-ma -accepteula %1% C:\dump\IISdump" customActionTriggerLimit="10">
      <traceAreas>
        <add provider="ASP" verbosity="Verbose" />
        <add provider="ASPNET" areas="Infrastructure,Module,Page,AppServices" verbosity="Verbose" />
        <add provider="ISAPI Extension" verbosity="Verbose" />
        <add provider="WWW Server" areas="Authentication,Security,Filter,StaticFile,CGI,Compression,Cache,RequestNotifications,Module,FastCGI" verbosity="Verbose" />
      </traceAreas>
      <failureDefinitions timeTaken="00:00:40" />
    </add>
  </traceFailedRequests>
</tracing>

</system.webServer>
</configuration>

    注意：failureDefinitions 部分可以设置生成 dump 的触发条件，我们这边是以 IIS 处理请求超过 40s 则生成 dump 为例，您可以根据自己的需求做一些改动。C:\dump\IISdump为生成 dump 的存放位置，您也可以根据自己的需求做修改。

  3. 修改目录 D:\Windows\System32\inetsrv\config 下的 applicationHost.config 文件
    在 system.applicationHost 部分做如下修改，添加 customActionsEnabled="true"

     <traceFailedRequestsLogging enabled="true"  maxLogFiles="1000" customActionsEnabled="true" />

    注意: customActionsEnabled 是需要添加的参数，因为我们是做 customize 的 dump 生成，如果不加，则 dump 无法自动生成。

  4. 如果您是像我的示例那样，将 dump 生成在 C 盘的某个位置，会因为要在 C 盘上写数据被 denial 掉，所以我们需要把该文件添加 everyone 权限，并且设置成 full control，但是如果您选择 dump 文件是生成在 E 盘或者其他非系统盘的位置，则可以不用做这一步。
    fullcontrol

  5. 验证该问题，可以生成 dump 文件：
    iis-dump