設定 Azure 雲端服務 （外延支援） 和虛擬機的診斷

注意

本文適用於 Azure Azure 雲端服務（外延支援）。 截至2024年8月31日，雲端服務（經典）已退休。 如需詳細資訊，請參閱 雲端服務（傳統）部署模型將於 2024 年 8 月 31 日淘汰。 針對新的開發，我們建議您使用專為特定用途設計的較新服務類型，例如 Azure App Service、Azure Functions 或 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 17.11中移除。 此外掛程式僅與本機 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 儲存體帳戶更新任何開發儲存體帳戶連接字串。 當您將專案發佈至 Azure 時，Visual Studio 會自動使用您在 [發佈精靈] 中指定的記憶體帳戶來更新診斷 連接字串。 不過，如果將實際的儲存體帳戶指定為診斷連接字串，則會改用該帳戶。

設定診斷資料來源

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

應用程式記錄檔

應用程式記錄具有 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 環境中的記錄架構。 如需詳細資訊，請參閱控制 azure Microsoft 中的記錄和追蹤，以及在 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 服務 中啟用 Web Apps 的診斷記錄。