Propagação
Este tópico descreve a propagação de atividades no modelo de rastreamento do WCF (Windows Communication Foundation).
Usar a propagação para correlacionar atividades entre pontos de extremidade
A propagação fornece ao usuário correlação direta de rastreamentos de erro para a mesma unidade de processamento entre pontos de extremidade do aplicativo, como, por exemplo, uma solicitação. Os erros emitidos em pontos de extremidade diferentes para a mesma unidade de processamento são agrupados na mesma atividade, mesmo entre domínios de aplicativo. Isso é feito por meio da propagação da ID da atividade nos cabeçalhos da mensagem. Portanto, se um cliente atingir o tempo limite devido a um erro interno no servidor, ambos os erros aparecerão na mesma atividade para correlação direta.
Para fazer isso, use a configuração ActivityTracing conforme demonstrado no exemplo anterior. Além disso, defina o atributo propagateActivity como a origem do rastreamento System.ServiceModel em todos os pontos de extremidade.
<source name="System.ServiceModel" switchValue="Verbose,ActivityTracing" propagateActivity="true" >
A propagação de atividade é uma funcionalidade configurável que faz com que o WCF adicione um cabeçalho às mensagens de saída, o que inclui a ID de atividade no TLS. Ao incluir isso em rastreamentos subsequentes no lado do servidor, podemos correlacionar atividades de cliente e servidor.
Definição de propagação
O gAId da atividade M será propagado para a atividade N se todas as condições a seguir se aplicarem.
N é criado por causa de M
O gAId de M é conhecido por N
O gAId de N é igual ao gAId de M.
O gAId é propagado por meio do cabeçalho da mensagem ActivityId, conforme ilustrado no esquema XML a seguir.
<xsd:element name="ActivityId" type="integer" minOccurs="0">
<xsd:attribute name="CorrelationId" type="integer" minOccurs="0"/>
</xsd:element>
Segue um exemplo do cabeçalho de mensagem.
<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="aaaa0000-bb11-2222-33cc-444444dddddd"
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>
Propagação e limites de atividade
Quando a ID da atividade é propagada entre pontos de extremidade, o receptor de mensagem emite um rastreamento Iniciar e Parar com essa ID de atividade (propagada). Portanto, há um rastreamento Iniciar e Parar com esse gAId de cada fonte de rastreamento. Se os pontos de extremidade estiverem no mesmo processo e usarem o mesmo nome de origem de rastreamento, vários Iniciar e Parar com o mesmo lAId (mesmo gAId, mesma fonte de rastreamento, mesmo processo) serão criados.
Synchronization
Para sincronizar eventos entre pontos de extremidade executados em computadores diferentes, uma CorrelationId é adicionada ao cabeçalho ActivityId propagado em mensagens. As ferramentas podem usar essa ID para sincronizar eventos entre computadores com discrepância de relógio. Especificamente, a ferramenta Visualizador de Rastreamento de Serviço usa essa ID para mostrar fluxos de mensagens entre pontos de extremidade.