Compartilhar via

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. Erros emitidos em diferentes pontos de extremidade para a mesma unidade de processamento são agrupados na mesma atividade, até mesmo entre diferentes domínios de aplicação. 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 ActivityTracing configuração, conforme demonstrado no exemplo anterior. Além disso, defina o atributo propagateActivity para a fonte de 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 a mensagens de saída, o que inclui a ID da 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.

A gAId é propagada 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>

Veja a seguir um exemplo do cabeçalho da 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>

Limites de propagação e 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.

Sincronização

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 esta identificação para mostrar os fluxos de mensagens entre endpoints.

Consulte também

  • Last updated on