傳播

本主題描述 Windows Communication Foundation (WCF) 追蹤模型中的活動傳播。

使用傳播將端點上的活動相互關聯

傳播會針對應用程式端點間的相同處理單位 (例如,要求),將錯誤追蹤的直接相互關聯提供給使用者。 在不同端點針對相同處理單位發出的錯誤會組成相同的活動群組,即使是跨應用程式定義域亦然。 這項工作是藉由傳播訊息標頭中的活動識別碼來達成。 因此,如果用戶端因為伺服器發生內部錯誤而逾時,則基於直接的相互關聯,這兩個錯誤都會出現在相同的活動中。

若要執行這項工作,請使用 ActivityTracing 設定,如前述範例所示。 此外,還要在所有端點上設定 propagateActivity 追蹤來源的 System.ServiceModel 屬性。

<source name="System.ServiceModel" switchValue="Verbose,ActivityTracing" propagateActivity="true" >  

活動傳播是可設定的功能,這項功能會促使 WCF 將標頭新增至傳出訊息,而其中會包含 TLS 上的活動識別碼。 將這個識別碼包含在對伺服器端的後續追蹤中,我們就可以將用戶端和伺服器活動相互關聯起來。

傳播定義

如果下列所有條件都成立,就會將活動 M 的 gAId 傳播至活動 N。

  • N 是因為 M 而建立的

  • N 知道 M 的 gAId

  • N 的 gAId 等於 M 的 gAId。

gAId 是透過 ActivityId 訊息標頭所傳播,如下列 XML 結構描述所示。

<xsd:element name="ActivityId" type="integer" minOccurs="0">  
  <xsd:attribute name="CorrelationId" type="integer" minOccurs="0"/>  
</xsd:element>  

下列是訊息標頭的範例。

<MessageLogTraceRecord>  
  <s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope"
                      xmlns:a="http://www.w3.org/2005/08/addressing">  
    <s:Header>  
      <a:Action s:mustUnderstand="1">http://Microsoft.ServiceModel.Samples/ICalculator/Subtract  
      </a:Action>  
      <a:MessageID>urn:uuid:f0091eae-d339-4c7e-9408-ece34602f1ce  
      </a:MessageID>  
      <ActivityId CorrelationId="f94c6af1-7d5d-4295-b693-4670a8a0ce34"
               xmlns="http://schemas.microsoft.com/2004/09/ServiceModel/Diagnostics">  
        17f59a29-b435-4a15-bf7b-642ffc40eac8  
      </ActivityId>  
      <a:ReplyTo>  
          <a:Address>http://www.w3.org/2005/08/addressing/anonymous</a:Address>  
      </a:ReplyTo>  
      <a:To s:mustUnderstand="1">net.tcp://localhost/servicemodelsamples/service</a:To>  
   </s:Header>  
   <s:Body>  
     <Subtract xmlns="http://Microsoft.ServiceModel.Samples">  
       <n1>145</n1>  
       <n2>76.54</n2>  
     </Subtract>  
   </s:Body>  
  </s:Envelope>  
</MessageLogTraceRecord>  

傳播和活動界限

在端點之間傳播活動識別碼時,訊息接收者會將「開始」和「停止」追蹤與這個 (傳播) 活動識別碼一起發出。 因此,會有包含來自每個追蹤來源之 gAId 的「開始」和「停止」追蹤。 如果數個端點位於相同的處理序且使用相同的追蹤來源名稱,就會建立多個具有相同 lAId (相同 gAId、相同追蹤來源、相同處理序) 的「開始」和「停止」追蹤。

同步處理

若要在執行於不同電腦的端點之間同步處理事件,請將 CorrelationId 新增至訊息中所傳播的 ActivityId 標頭。 工具可以使用這個識別碼,在時鐘不一致的電腦之間同步處理事件。 具體來說,「服務追蹤檢視器」工具會使用這個識別碼來顯示端點之間的訊息流動。

另請參閱