共用方式為

啟用應用程式層級追蹤

  • 發行項

您可以在應用程式根目錄的 Web.config 檔案中啟用整個應用程式的追蹤。依預設，應用程式層級追蹤只能在本機 Web 伺服器電腦上檢視。您必須在 Web.config 檔案中，將 localOnly 屬性設定為 false，讓遠端電腦可以看見應用程式層級的追蹤資訊。

**警告   **若要協助保護 Web 應用程式的安全，請只在開發或部署應用程式時才使用遠端追蹤功能。務必在將應用程式傳輸到實際執行 Web 伺服器之前將之停用。若要停用遠端追蹤，在 Web.config 檔案中將 localOnly 屬性設定為 true。

下列範例示範應用程式追蹤組態，其中收集多達 40 個要求的追蹤資訊，並允許電腦的瀏覽器而非原始伺服器顯示追蹤檢視器。

<configuration>
 <system.web>
  <trace enabled="true" requestLimit="40" localOnly="false"/>
 </system.web>
</configuration>

當您啟用應用程式的追蹤時，ASP.NET 會收集對應用程式各個要求的追蹤資訊，多達您指定的最大要求數。要求的預設數目為 10。當追蹤檢視器到達其要求限制時，應用程式會停止儲存追蹤要求。

**注意   **當您在 Web.config 檔案中啟用整個應用程式的追蹤時，會為該應用程式的每個網頁收集和處理追蹤資訊。若要停用應用程式中特定網頁的追蹤，請將該網頁的 @ Page 指示詞中的 Trace 屬性設定為 false。包括在網頁程式碼中的任何 TraceContext.Write 或 TraceContext.Warn 陳述式只會存放並傳回至追蹤檢視器。

如果您要追蹤資訊出現在相關網頁的結尾，請將 Web.config 檔案追蹤組態區段中的 pageOutput 屬性設定為 true。如果您想要追蹤資訊僅顯示於追蹤檢視器，請將這個屬性設定為 false。如果您啟用應用程式層級追蹤，但不想要追蹤資訊向應用程式的某些網頁顯示，請使用 @ Page 指示詞，將那些您不想要顯示追蹤資訊的網頁的 Trace 屬性設定為 false。

如需設定您ASP.NET 應用程式的詳細資訊，請參閱 ASP.NET 組態。

下列是您可以用來修改應用程式層級追蹤行為的所有屬性。

屬性 說明
enabled 如果啟用應用程式的追蹤，則為 true；否則為 false。預設為 false。
pageOutput 如果追蹤資訊會同時顯示在應用程式的網頁和 .axd 追蹤公用程式中，則為 true；否則為 false。預設為 false。
注意   已啟用追蹤的網頁不受這個設定值影響。
requestLimit 要儲存在伺服器上的追蹤要求數。預設值是 10。
traceMode 指示追蹤資訊應該依處理的順序 (SortByTime) 或是依使用者定義的分類的字母順序 (SortByCategory) 來顯示。預設為 SortByTime。
localOnly 如果追蹤檢視器 (Trace.axd) 只能在主機 Web 伺服器上使用，則為 true；否則為 false。預設值是 true。

若要啟用應用程式的追蹤

  1. 如果您還沒有如此做，請建立文字檔、將它命名為 Web.config，並將它儲存到您應用程式的根目錄。

  2. 在 <configuration> 項目的開頭和結尾標記 (Tag) 之間，加入 <system.web> 項目的開頭和結尾標記。

  3. 在 <system.web> 項目標記之間，加入 <trace> 項目，該項目自行結尾的。

  4. 在 <trace> 項目中，宣告 enabled 屬性並設定為 true。

  5. 宣告其他選擇性屬性，照您所想的來修改應用程式的追蹤行為。

    例如，下列應用程式追蹤組態將收集多達 40 個要求的追蹤資訊，並允許電腦的瀏覽器而非原始伺服器顯示追蹤檢視器。

    <configuration>
 <system.web>
  <trace enabled="true" requestLimit="40" localOnly="false"/>
 </system.web>
</configuration>

    **注意   **ASP.NET 組態系統要區分大小寫。所有單個字的組態區段為小寫，由兩個字串連的區段或屬性則必須將第二個字的首字母大寫。例如，requestLimit 是有效的屬性名稱，但 requestlimit 會造成剖析器 (Parser) 錯誤。

使用追蹤檢視器檢視追蹤資訊

一旦您已經啟用應用程式的追蹤，當應用程式中的每個網頁受到要求時，它將會執行所有包含的追蹤陳述式。您可以從應用程式目錄的根目錄要求 Trace.axd，在追蹤檢視器中檢視這些陳述式和其他的追蹤資訊。

**注意   **當您啟用應用程式的追蹤時，可以將 Web.config 檔案中的 pageOutput 屬性設定為 true，來檢視追蹤陳述式和應用程式中任何網頁的額外資訊。

追蹤檢視器允許您從應用程式要求過的網頁中選擇特定要求。下列範例圖片示範追蹤檢視器，在從追蹤啟用以來有七個對應用程式產生的要求。

追蹤檢視器

如果針對啟用追蹤的應用程式產生的多個要求已經到達，追蹤檢視器會按它們的處理順序來列出要求。追蹤檢視器的開啟網頁的資訊包括要求的時間、要求的檔案、要求的狀態碼、與要求相關的 HTTP 動作，和 [檢視詳細資料] 連結 (允許您看到更多要求的詳細資訊)。顯示的要求數目將不會超過您在 Web.config 檔案中指定的 requestLimit 設定值。

若要檢視特定要求的追蹤詳細資料

  1. 巡覽至與您的應用程式相關的追蹤檢視器。

    例如，如果您應用程式的 URL 為 https://localhost/myapplication，則巡覽至 https://localhost/myapplication/trace.axd 以檢視該應用程式的追蹤統計資料。

  2. 選取您想要調查之要求的 [檢視詳細資料] 連結。

    一旦您選取 [檢視詳細資料] 之後，您將檢視附加至已啟用追蹤的網頁之相同資訊。

在某些情況中，您可能想要移除儲存在追蹤檢視器中的所有要求。或許您想要追蹤您在應用程式中對檔案所做的變更，或者您只是想要檢視與目前顯示的要求相關的檔案以外檔案的資訊。

若要從追蹤檢視器清除要求

  1. 巡覽至與應用程式相關的追蹤檢視器。

  2. 選取 [清除目前的追蹤] 連結以移除存放在追蹤檢視器應用程式中的所有要求。

    **注意   **追蹤檢視器只追蹤您清除記錄之後產生的要求。無法檢視到達要求限制之後以及您清除記錄之前的要求。

請參閱

TraceModeEnum 列舉型別 | ASP.NET 追蹤 | ASP.NET 設定結構描述 | 啟用網頁的追蹤功能