共用方式為


並行視覺化檢視標記

在並行視覺化檢視中,標記是代表應用程式中事件的圖示。 一般而言,應用程式會產生這些事件,以指定應用程式中的階段或發生次數。 應用程式或程式庫和應用程式使用的執行階段,可以產生事件。

標記類型

並行視覺化檢視使用三種類型的標記來表示應用程式事件︰旗標、訊息和範圍。

  1. 使用旗標可指出應用程式中有趣的時間點。 例如,您可以使用旗標來表示變數值已達到特定的閾值或表示擲回例外狀況。

  2. 訊息也可標記時間點,但是您可以使用它追蹤記錄檔樣式。 例如,您現在可以在訊息呼叫中包裝傾印到記錄檔的內容以便追蹤,並在並行視覺化檢視中檢視。 您也可以使用並行視覺化檢視將此資料匯出至 CSV 檔案。

  3. 範圍代表應用程式中一個時間間隔,例如其中一個階段。

執行緒標記連結

產生標記的每個執行緒都有不同的時間軸通道。 負責產生標記事件的執行緒識別碼會顯示在標記通道的描述旁邊。 標記通道左邊顯示的識別碼符合目前處理序中另一個執行緒的 ID。

標記重要性

標記可以有其中一種四種重要性層級︰低、標準、高和重要。 您可以根據重要性層級篩選標記的來源。 例如,如果您只想看到來自特定來源有一般或重要重要性的標記,您可以在進階設定對話方塊中設定篩選。 標記的重要性會顯示在其工具提示和標記報告中。

標記分類

標記分類表示一組來自相同來源的標記事件。 並行視覺化檢視使用色彩來區別不同分類的旗標和範圍。 您可以設定並行視覺化檢視以使用分類來篩選來自特定事件提供者的標記事件。 使用 [進階設定] 對話方塊可設定篩選。

已知的標記來源

只要提供者符合某些限制式,任何 ETW 提供者都可以產生標記。 您可以設定並行視覺化檢視來接聽其他事件來源的標記。 預設會接聽這些事件來源︰

來自 EventSource 的標記

並行視覺化檢視也可以顯示 EventSource 事件。 如需詳細資訊,請參閱將 EventSource 事件顯示為標記

旗標標記

旗標標記表示在應用程式時間中的某個時刻發生的項目。 旗標可代表許多種類的應用程式事件。 比方說,當特定工作項目已排程或擲回例外狀況時,可以顯示旗標。 工作平行程式庫等的執行階段也可以產生旗標。

旗標重要性

旗標會依其重要性以不同的大小顯示。 與所有標記一樣,重要性可以是低、普通、高或嚴重。 下圖顯示標記的外觀 (依重要性層級排列)︰

Illustration of Low, Normal, High, and Critical importance markers.

旗標分類

旗標共有五種不同的色彩,依其分類以其中一種顯示。 如果有五種以上的類別,則會重複使用這些色彩。 您無法選擇色彩。 與所有標記一樣,分類可以是任何整數。 下圖顯示前五個類別的色彩。

Illustration of five colors of category markers.

警示

警示為紅色旗標,表示嚴重的應用程式事件,例如例外狀況。 以下是警示︰

Illustration of the Concurrency Visualizer alert marker.

彙總旗標

有時旗標發生的位置太靠近並行視覺化檢視中的另一個旗標,以至於無法個別繪製。 發生這種情況時,會顯示一個表示基礎旗標的灰色彙總旗標。 當您將指標放在這些圖示的其中一個時,工具提示會顯示所代表基礎旗標的數目。 若要檢視旗標,請將它放大。 如果您縮放到最大後仍然出現彙總旗標,可以在標記報表中檢視基礎旗標。

彙總旗標以不同大小繪製。 大小取決於最重要的旗標在彙總中的重要性層級。 下圖顯示以遞增的重要性順序排序的彙總旗標。

Illustration of aggregate flags showing four levels of importance.

訊息標記

訊息標記表示記錄檔輸出。 訊息是由特定執行緒在特定時間發出的字串。 您可以將訊息匯出成文字檔,以便與其他工具搭配使用。 您可以將指標放在並行視覺化檢視中的訊息上,以檢視訊息字串。 您可以在標記報表中檢視所有訊息標記。 下圖顯示訊息標記。

訊息彙總標記

有時多個訊息發生的位置太靠近並行視覺化檢視中的另一個標記,以至於無法個別繪製。 發生這種情況時,會顯示一個表示基礎訊息的灰色「訊息彙總標記」。 當您將指標放在這些圖示的其中一個時,工具提示會顯示所代表基礎訊息的數目。 若要檢視訊息,請予以放大。 如果您縮放到最大後仍然出現彙總標記,您可以在標記報告中檢視基礎訊息。

範圍標記

延伸標記表示有意義的應用程式階段。 例如,您可以使用延伸範圍,表示其間正在處理特定工作項目的時間間隔。 其長度代表對應的應用程式階段持續時間。 下圖顯示並行視覺化檢視中的延伸範圍︰

Illustration of a span marker in Concurrency Visualizer.

延伸分類

延伸標記共有五種不同的色彩,依其分類以其中一種顯示。 如果有五種以上的類別,則會重複這些色彩。 分類可以是任何整數。 下圖顯示五種可能的色彩︰

Illustration of five spans in different categories.

延伸彙總標記

有時延伸標記發生的位置太靠近並行視覺化檢視中的另一個標記,以至於無法個別繪製。 發生這種情況時,會顯示一個表示基礎延伸範圍的灰色「延伸彙總標記」。 當您將指標放在這些圖示的其中一個時,工具提示會顯示所代表基礎延伸範圍的數目。 若要檢視延伸範圍,請予以放大。 如果您縮放到最大後仍然出現延伸彙總標記,您可以在標記報告中檢視基礎延伸標記。 下圖顯示延伸彙總標記︰

Illustration of an aggregate span marker in Concurrency Visualizer.