使用 Azure 診斷追蹤雲端服務 (傳統) 應用程式的流程

文章
02/28/2024

重要

針對新客戶目前已取代 Azure 雲端服務 (傳統)，而針對所有客戶，該服務將從 2024 年 8 月 31 日起完全淘汰。新部署應該使用 Azure Resource Manager 型的新部署模型 Azure 雲端服務 (延伸支援)。

追蹤可讓您在應用程式執行時，監視應用程式的執行。您可以使用 System.Diagnostics.Trace、System.Diagnostics.Debug 和 System.Diagnostics.TraceSource 類別，在記錄、文字檔或其他裝置中記錄錯誤和應用程式執行的相關資訊，供稍後分析。如需追蹤的詳細資訊，請參閱追蹤和檢測應用程式。

使用追蹤陳述式和追蹤參數

藉由加入 DiagnosticMonitorTraceListener 至應用程式組態，並在您的應用程式程式碼中對 System.Diagnostics.Trace 或 System.Diagnostics.Debug 進行呼叫，藉此在雲端服務應用程式中實作追蹤。將組態檔 app.config 用於背景工作角色，將 web.config 用於 Web 角色。使用 Visual Studio 範本建立新的託管服務時，Azure 診斷會自動加入至專案，並且 DiagnosticMonitorTraceListener 會加入至您所加入角色的適當組態檔。

如需有關放置追蹤陳述式資訊，請參閱作法：加入 Trace 陳述式至應用程式程式碼。

將追蹤參數放在您的程式碼中，可控制是否進行追蹤及其廣泛程度。這可讓您監視應用程式在生產環境中的狀態。這很重要，特別是在有多個元件在多部電腦上執行的商務應用程式中。如需詳細資訊，請參閱如何：設定追蹤參數。

在 Azure 應用程式中設定追蹤接聽程式

Trace、Debug 和 TraceSource，需要您設定「接聽程式」來收集和記錄傳送的訊息。接聽程式會收集、儲存和路由傳送追蹤訊息。它們將追蹤輸出導向至適當的目標，例如記錄檔、視窗或文字檔。 Azure 診斷使用 DiagnosticMonitorTraceListener 類別。

完成下列程序之前，您必須初始化 Azure 診斷監視器。若要這樣做，請參閱在 Microsoft Azure 中啟用診斷。

請注意，如果您使用 Visual Studio 所提供的範本，則會自動為您加入接聽程式的組態。

加入追蹤接聽程式

開啟您的角色的 web.config 或 app.config 檔案。

將下列程式碼新增至檔案。變更 Version 屬性以使用您所參考的組件版本號碼。除非有更新，否則組件版本不一定會隨著每個 Azure SDK 版本而變更。

<system.diagnostics>
    <trace>
        <listeners>
            <add type="Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitorTraceListener,
              Microsoft.WindowsAzure.Diagnostics,
              Version=2.8.0.0,
              Culture=neutral,
              PublicKeyToken=31bf3856ad364e35"
              name="AzureDiagnostics">
                <filter type="" />
            </add>
        </listeners>
    </trace>
</system.diagnostics>

重要

請確定您有參照 Microsoft.WindowsAzure.Diagnostics 組件的專案參考。更新上述 xml 中的版本號碼，以和參考的 Microsoft.WindowsAzure.Diagnostics 組件版本相符。

儲存組態檔。

如需接聽程式的詳細資訊，請參閱追蹤接聽程式。

完成加入接聽程式的步驟之後，您可以加入您的追蹤陳述式到程式碼中。

將追蹤陳述式加入至您的程式碼

開啟您的應用程式的原始程式檔。例如，背景工作角色或 Web 角色的 <RoleName>.cs 檔案。
加入下列 using 指示詞 (如果尚未加入)：
```
    using System.Diagnostics;
```
在您想要用來擷取應用程式狀態資訊的位置加入 Trace 陳述式。您可以使用各種方法來格式化 Trace 陳述式的輸出。如需詳細資訊，請參閱做法：加入 Trace 陳述式至應用程式程式碼。
儲存原始程式檔。

分享方式：