【Azure 雲服務】Azure Cloud Service 為 Web Role（IIS Host）增加自定義欄位 （把HTTP Request Header中的User-Agent欄位增加到IIS輸出日誌中）

• 2021 年 10 月 13 日
• 筆記
• 【Azure 雲服務】, Azure Developer, Cloud Service, Web Role（IIS Host）增加自定義欄位, 把HTTP Request Header中的User-Agent欄位增加到IIS輸出日誌中

問題描述

把Web Role服務發布到Azure Cloud Service後，需要在IIS的輸出日誌中，把每一個請求的HTTP Request Header中的User-Agent內容也輸出到日誌中。通過Cloud Service（雲服務）如何實現呢？

解決方案

方案一（臨時）：Cloud Service WebRole是Host在IIS中，所以可以通過對IIS的Logging設置就可以（RDP到VM中修改）

1：RDP到雲服務的實例上，搜索IIS Manager 

2：打開之後，找到雲服務實例，點擊Logging。 如下截圖所示：

3：打開之後，在Log File 裡面的Format 選擇W3C ，點擊Select Fields,進行添加自定義欄位

4：修改完成後，新生成的IIS日誌中就會包含列名為UUID，內容為User-Agent的內容。

方案二：通過Cloud Service的啟動任務對IIS Logging進行設置（需重新部署一次雲服務）

1：在Cloud Service中設置啟動任務，在WebRole項目的ServiceDefinition.csdef文件中加入 Startup 內容：

<Startup>
    <Task commandLine="Startup.cmd" executionContext="limited" taskType="simple" >
        <Environment>
            <Variable name="MyVersionNumber" value="1.0.0.0" />
        </Environment>
    </Task>
</Startup>

2: 在項目根目錄中添加文件 Startup.cmd，文件內容為：

d /d "%~dp0"

%windir%\system32\inetsrv\appcmd.exe set config -section:system.applicationHost/sites /+"siteDefaults.logFile.customFields.[logFieldName='UUID',sourceName='User-Agent',sourceType='RequestHeader']" /commit:apphost >> "%TEMP%\StartupLog.txt" 2>&1

exit /b 0

PS: 通過修改IIS config的方式來配置Loggin中的自定義日誌欄位

3: 重新部署整個Cloud Service，即可生效。

參考資料

如何配置和運行 Azure 雲服務（經典）的啟動任務：//docs.microsoft.com/zh-cn/azure/cloud-services/cloud-services-startup-tasks#example-of-a-startup-task

Adding Custom Fields to a Log File for a Site <add> : //docs.microsoft.com/en-us/iis/configuration/system.applicationhost/sites/site/logfile/customfields/add#sample-code

如何在部署雲服務Cloud Service時候通過啟動任務Start Task來配置IIS (如開啟ARR) : //www.cnblogs.com/lulight/p/13579629.html