針對 Azure 雲端服務與虛擬機器設定診斷

注意

本文適用於 Azure 雲端服務 (傳統版)，該服務目前針對新客戶已取代，並將於 2024 年 8 月 31 日淘汰。 使用此技術建置的現有服務仍可透過雲端服務 (延伸支援)獲得支援。。 針對新的開發，我們建議您使用專為特定用途設計的較新服務類型，例如 Azure App Service、Azure Functions 或 Azure 容器應用程式。 如需可用服務的最新清單，請參閱 Azure 產品的目錄。

需要針對 Azure 雲端服務或 Azure 虛擬機器進行疑難排解時，您可以使用 Visual Studio 更輕鬆地設定 Azure 診斷。 診斷會在執行雲端服務的虛擬機器和虛擬機器執行個體上擷取系統資料和記錄資料。 診斷資料會傳輸到您選擇的儲存體帳戶。 如需 Azure 中診斷記錄的詳細資訊，請參閱在 Azure App Service 中針對 Web 應用程式啟用診斷記錄。

在本文中，我們示範如何在部署前後使用 Visual Studio 來開啟並設定 Azure 診斷。 了解如何在 Azure 虛擬機器上設定診斷、如何選取要收集的診斷資訊類型，以及如何在收集之後檢視資訊。

若要設定 Azure 診斷，在 Visual Studio 的 [診斷設定] 對話方塊中變更診斷設定。 這些設定會儲存在名為 diagnostics.wadcfgx 的檔案中。 您也可以直接修改設定檔。 如果您手動更新檔案，設定變更會在您下一次將雲端服務部署至 Azure 或在模擬器中執行服務時生效。

警告

在 Visual Studio 2022 中偵錯雲端服務專案時，已遭淘汰的 Azure 儲存體模擬器已為 Azurite 模擬器所取代。 此 Azurite 模擬器無法與 Azure 診斷外掛程式搭配運作，後者可在本機執行與測試時支援 Azure 診斷。 如需適用於本機執行與測試案例的外掛程式，可以將本機服務組態 (.cscfg) 中的連接字串更新為 Azure 儲存體帳戶 (請參閱管理儲存體帳戶的連接字串)，或下載舊版的 Azure 儲存體模擬器。 在 Visual Studio 17.10 版本中，本機 Azure 診斷外掛程式即將淘汰，並會預設為停用，但可以在該版本中選擇啟用。 由於該外掛程式即將淘汰，未来的 Visual Studio 的版本可能會移除該外掛程式。 此外掛程式只能與本機 Azure 計算模擬器搭配使用，且停用後不會影響已在 Azure 中部署並使用 Azure 診斷延伸模組的雲端服務。 若要在 Visual Studio 17.10 中啟用診斷外掛程式，請將下列屬性設定新增至您專案檔中的任何 PropertyGroup：<EnableEmulatorDiagnosticsPlugin>True</EnableEmulatorDiagnosticsPlugin>。

Visual Studio 如何決定診斷儲存體帳戶

• 如果在 .cscfg 檔案中指定診斷連接字串，Visual Studio 會在發佈期間，以及在封裝期間產生公用設定 XML 檔案時，使用它來設定診斷延伸模組。
• 如果未在 .cscfg 檔案中指定診斷連接字串，Visual Studio 會回復到使用 .wadcfgx 檔案中指定的儲存體帳戶來設定診斷延伸模組，以進行發佈以及在封裝期間產生公用設定 XML 檔案。
• 在 .cscfg 檔案中的診斷連接字串的優先順序高於 .wadcfgx 檔案中的儲存體帳戶。 如果在 .cscfg 檔案中指定診斷連接字串，Visual Studio 會使用該連接字串，並忽略 .wadcfgx 中的儲存體帳戶。

「更新開發儲存體連接字串...」核取方塊的功用？

[在發佈至 Microsoft Azure 時使用 Microsoft Azure 儲存體帳戶認證更新診斷和快取的開發儲存體連接字串] 核取方塊是一種便利方式，可使用發佈期間指定的 Azure 儲存體帳戶更新任何開發儲存體帳戶連接字串。

例如，如果您選取此核取方塊，而且診斷連接字串指定 UseDevelopmentStorage=true，則在您將專案發佈至 Azure 時，Visual Studio 會使用您在發佈精靈中指定的儲存體帳戶，自動更新診斷連接字串。 不過，如果將實際的儲存體帳戶指定為診斷連接字串，則會改用該帳戶。

部署雲端服務專案中的診斷之前先將其開啟

在 Visual Studio 中，當您在部署之前執行模擬器中的服務時，就可以收集在 Azure 中執行之角色的診斷資料。 在 Visual Studio 中對診斷設定進行的所有變更都會儲存在 diagnostics.wadcfgx 組態檔中。 這些設定會在您部署雲端服務時指定儲存診斷資料的儲存體帳戶。

警告

當您在現有角色上啟用診斷功能時，您已設定的任何擴充功能都會在部署套件時停用。 包括：

• Microsoft Monitoring Agent 診斷
• Microsoft Azure 安全性監控
• Microsoft Antimalware \(部分機器翻譯\)
• Microsoft Monitoring Agent
• Microsoft 服務分析工具代理程式
• Windows Azure 網域擴充功能
• Windows Azure 診斷擴充功能
• Windows Azure 遠端桌面擴充功能
• Windows Azure 記錄檔收集器

在部署更新的角色之後，您可以透過 Azure 入口網站或 PowerShell 重設您的擴充功能。

在部署之前開啟 Visual Studio 中的診斷

1. 在角色的捷徑功能表上，選取 [屬性]。 在角色的 [屬性] 對話方塊中，選取 [設定] 索引標籤。

2. 在 [診斷] 區段中，確定已選取 [啟用診斷] 核取方塊。

   

3. 若要指定診斷資料的儲存體帳戶，請選擇省略符號 (...) 按鈕。

   

4. 在 [建立儲存體連接字串] 對話方塊中，指定要使用 Azure 儲存體模擬器、Azure 訂閱或手動輸入的認證來連接。

   

   • 如果您選取Microsoft Azure 儲存體模擬器，則連接字串會設定為 UseDevelopmentStorage=true。
   • 如果選取 [您的訂閱]，您可以選取要使用的 Azure 訂閱，並輸入帳戶名稱。 若要管理您的 Azure 訂閱，請選取 [管理帳戶]。
   • 如果您選取 [手動輸入的認證]，請輸入您想要使用之 Azure 帳戶的名稱和金鑰。

5. 若要檢視 [診斷設定] 對話方塊，請選取 [設定] 對話方塊。 除了 [一般] 和 [記錄目錄] 之外，每個索引標籤都代表您可以收集的診斷資料來源。 預設 [一般] 索引標籤提供下列診斷資料收集選項：[只限錯誤]、[所有資訊]，以及 [自訂方案]。 預設 [只記錄錯誤] 選項會佔用最少的儲存體，因為它不會傳輸警告或追蹤訊息。 [所有資訊] 選項會傳輸大部分的資訊、使用最多的儲存體，因此它是最昂貴的選項。

   注意

   「以 MB 為單位的磁碟配額」支援的大小下限為 50 MB，且預設大小為 4 GB。 不過，如果您有收集記憶體傾印，請將這個值增加為較高的值，例如 10 GB。

   

6. 在此範例中，請選取 [自訂計劃] 選項，您就可以自訂收集的資料。

7. 在 [以 MB 為單位的磁碟配額] 方塊中，您可以設定要在儲存體帳戶中配置診斷資料的空間大小。 您可以變更或接受預設值。

8. 在您想要收集之診斷資料的每個索引標籤上，選取 [啟用 <log type> 的傳輸] 核取方塊。 例如，如果您想要收集應用程式記錄檔，請在 [應用程式記錄檔] 索引標籤上選取 [啟用應用程式記錄檔的傳輸] 核取方塊。 此外，請指定每個診斷資料類型所需的其他資訊。 如需每個索引標籤的設定資訊，請參閱本文稍後的 設定診斷資料來源一節。

9. 啟用所有您想要的診斷資料收集之後，請選取 [確定]。

10. 如往常一般在 Visual Studio 中建立 Azure 雲端服務專案。 當您使用您的應用程式，您已啟用的記錄檔資訊會儲存到您指定的 Azure 儲存體帳戶。

設定診斷資料來源

啟用診斷資料收集之後，您可以準確選擇您要收集的資料來源和所收集的資訊。 以下幾節描述 [診斷設定] 對話方塊中的索引標籤，以及每個設定選項的意義。

應用程式記錄檔

應用程式記錄具有 Web 應用程式所產生的診斷資訊。 如果您想要擷取應用程式記錄檔，請選取 [啟用應用程式記錄檔傳輸] 核取方塊。 若要增加或減少將應用程式記錄傳輸至儲存體帳戶的間隔，請變更 [傳輸期間 (分鐘)] 值。 您也可以藉由設定記錄層級值變更記錄檔中擷取的資訊量。 例如，選取 [Verbose] 以取得詳細資訊，或選取 [嚴重] 只擷取嚴重的錯誤。 如果您有特定的診斷提供者會發出應用程式記錄，您可以藉由將提供者的 GUID 新增至 [提供者 GUID] 方塊來擷取記錄。

如需應用程式記錄的詳細資訊，請參閱在 Azure App Service 中針對 Web 應用程式啟用診斷記錄。

Windows 事件記錄

若要擷取 Windows 事件記錄，請選取 [啟用 Windows 事件記錄傳輸] 核取方塊。 若要增加或減少將事件記錄傳輸至儲存體帳戶的間隔，請變更 [傳輸期間 (分鐘)] 值。 選取您想要追蹤之事件類型的核取方塊。

如果您想要指定自訂資料來源，請在 <[資料來源名稱]> 文字方塊中將其輸入，然後選取 [新增]。 資料來源會新增至 diagnostics.cfcfg 檔案。

效能計數器

效能計數器資訊可協助您找出系統瓶頸並微調系統和應用程式效能。 如需詳細資訊，請參閱在 Azure 應用程式中建立及使用效能計數器。 若要擷取效能計數器，請選取 [啟用效能計數器的傳輸] 核取方塊。 若要增加或減少將事件記錄傳輸至儲存體帳戶的間隔，請變更 [傳輸期間 (分鐘)] 值。 選取您想要追蹤之效能計數器的核取方塊。

若要追蹤未列出的效能計數器，請使用建議的語法輸入效能計數器。 然後，選取 [新增]。 虛擬機器上的作業系統會決定您可以追蹤的效能計數器。如需語法的詳細資訊，請參閱指定計數器路徑。

基礎結構記錄檔

基礎結構記錄具有 Azure 診斷基礎結構、RemoteAccess 模組和 RemoteForwarder 模組的相關資訊。 若要收集基礎結構記錄的相關資訊，請選取 [啟用基礎結構記錄的傳輸] 核取方塊。 若要增加或減少將基礎結構記錄傳輸至儲存體帳戶的間隔，請變更 [傳輸期間 (分鐘)] 值。

如需詳細資訊，請參閱 使用 Azure 診斷收集記錄資料。

記錄檔目錄

記錄目錄具有從 Internet Information Services (IIS) 要求、失敗要求，或您選擇之資料夾的記錄目錄中收集的資料。 若要擷取記錄目錄，請選取 [啟用記錄目錄的傳輸] 核取方塊。 若要增加或減少將記錄傳輸至儲存體帳戶的間隔，請變更 [傳輸期間 (分鐘)] 值。

選取您想要收集之記錄的核取方塊，例如 [IIS 記錄] 和 [失敗要求] 記錄。 提供預設儲存體容器名稱，但您可以變更名稱。

您可以從任何資料夾擷取記錄。 在 [絕對目錄中的記錄] 區段中指定路徑，然後選取 [新增目錄]。 記錄會擷取至指定的容器。

ETW 記錄檔

如果您使用 Windows 事件追蹤 (ETW) 而且想要擷取 ETW 記錄檔，請選取 [啟用 ETW 記錄檔的傳輸] 核取方塊。 若要增加或減少將記錄傳輸至儲存體帳戶的間隔，請變更 [傳輸期間 (分鐘)] 值。

從事件來源和您指定的事件資訊清單擷取事件。 若要指定事件來源，請在 [事件來源] 區段中輸入名稱，然後選取 [新增事件來源]。 同樣地，您可以指定 [事件資訊清單] 區段中的事件資訊清單，然後選取 [新增事件資訊清單]。

透過 System.Diagnostics.aspx 命名空間中的類別，支援 ASP.NET 中的 ETW 架構。 Microsoft.WindowsAzure.Diagnostics 命名空間 (繼承自並擴充標準 System.Diagnostics.aspx 類別) 可讓您使用 System.Diagnostics.aspx 作為 Azure 環境中的記錄架構。 如需詳細資訊，請參閱在 Microsoft Azure 中控制記錄和追蹤和在 Azure 雲端服務和虛擬機器中啟用診斷。

損毀傾印

若要擷取角色執行個體何時損毀的相關資訊，請選取 [啟用損毀傾印的傳輸] 核取方塊。 (由於 ASP.NET 處理大多數例外狀況，這通常只對背景工作角色才有用。)若要增加或減少專用於損毀傾印的儲存空間百分比，您可以變更目錄配額 (%) 值。 您可以變更儲存損毀傾印的儲存體容器，也可以選取您想要擷取完整或最小傾印。

下一個螢幕擷取畫面列出目前正在追蹤的處理序。 選取您想要擷取之處理序的核取方塊。 若要將另一個處理序新增至清單，請輸入處理序名稱，然後選擇 [新增處理序]。

如需詳細資訊，請參閱在 Microsoft Azure 中控制記錄和追蹤。

疑難排解 Azure 雲端服務問題

如果您遇到雲端服務專案的相關問題，例如陷入「忙碌」狀態的角色、重複回收，或擲回內部伺服器錯誤，您都可以使用工具和技術診斷和修正問題。 如需常見問題和解決方案的特定範例，以及您可以用來診斷和修正這些錯誤的概念和工具概觀，請參閱 Azure 平台即服務 (PaaS) 運算診斷資料。

問與答

何謂緩衝區大小和適當大小？

在每個虛擬機器執行個體上，配額會限制可以儲存在本機檔案系統上的診斷資料數量。 此外，您可以為每種診斷資料類型指定可用的緩衝區大小。 這個緩衝區大小就像是該資料類型的個別配額。 若要判斷整體配額和剩餘的記憶體數量，請查看對話方塊底部，以取得診斷資料類型。 如果您指定較大的緩衝區或更多類型的資料，您會愈趨近整體配額。 您可以藉由修改 diagnostics.wadcfgx 設定檔變更整體配額。 診斷資料會與您的應用程式資料儲存在同一個檔案系統中。 如果您的應用程式使用大量磁碟空間，您不應該增加整體診斷配額。

何謂傳輸週期和適當時間長度？

傳輸週期是資料擷取之間經過的時間量。 每個傳輸週期之後，資料會從虛擬機器上的本機檔案系統上移至儲存體帳戶中的資料表。 如果收集的資料量在傳輸週期結束前超過配額，則會捨棄較舊的資料。 如果您因為資料超過緩衝區大小或整體配額而遺失資料，您可能會想要縮短傳輸週期。

時間戳記位於哪個時區？

時間戳記位於裝載雲端服務之資料中心的當地時區。 使用下列記錄資料表中的三個時間戳記資料行：

• PreciseTimeStamp：事件的 ETW 時間戳記。 也就是從用戶端記錄事件的時間。
• TIMESTAMP：PreciseTimeStamp 無條件捨去到上傳頻率界限的值。 例如，如果您的上傳頻率為 5 分鐘，而事件時間為 00:17:12，則 TIMESTAMP 是 00:15:00。
• Timestamp：Azure 資料表中建立實體的時間戳記。

收集診斷資訊時如何管理成本？

預設設定 (將 [記錄層級] 設為 [錯誤] 並將 [傳輸週期] 設為 [1 分鐘]) 的設計目的是將成本降至最低。 當收集更多診斷資料時，或如果縮短傳輸週期，會增加運算成本。 請勿收集超過需求量的資料，也別忘了在您不需要時停用資料收集。 您可以一律重新啟用它，即使在執行階段也一樣，如本文稍早所述。

如何從 IIS 收集失敗要求記錄檔？

根據預設，IIS 不會收集失敗要求記錄檔。 您可以編輯 Web 角色的 web.config 檔案，設定 IIS 來收集失敗要求記錄。

我無法從 OnStart 之類的 RoleEntryPoint 方法取得追蹤資訊。 有什麼問題？

RoleEntryPoint 的方法是在 WAIISHost.exe 的內容中呼叫，而不在 IIS 中。 在通常會啟用追蹤的 web.config 中，設定資訊並不適用。 若要解決這個問題，請將.config 檔案新增至 web 角色專案，並將檔案命名以符合包含 RoleEntryPoint 程式碼的輸出組件。 在預設 web 角色專案中，.config 檔案的名稱應該是 WAIISHost.exe.config。將下列幾行新增至此檔案：

<system.diagnostics>
  <trace>
      <listeners>
          <add name "AzureDiagnostics" type="Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitorTraceListener">
              <filter type="" />
          </add>
      </listeners>
  </trace>
</system.diagnostics>

在 [屬性] 視窗中，將 [複製到輸出目錄] 屬性設為 [永遠複製]。

相關內容

若要深入了解 Azure 中的診斷記錄，請參閱在 Azure 雲端服務和虛擬機器中啟用診斷和在 Azure App Service 中啟用 Web 應用程式的診斷記錄。