Participantes de rastreamento
Os participantes de rastreamento são os pontos de extensibilidade que permitem que um desenvolvedor de fluxo de trabalho acessar objetos de TrackingRecord e processe os. O .NET Framework 4.6.1 inclui um participante padrão de rastreamento que grava registros de rastreamento como eventos de ETW (Rastreamento de Eventos para Windows). Se isso não atender aos requisitos, você também poderá escrever um participante de rastreamento personalizado.
Participantes de rastreamento
A infraestrutura de rastreamento permite que o aplicativo de um filtro os registros de saída de rastreamento para que um participante pode assinar um subconjunto de registros. O mecanismo para aplicar um filtro é com um perfil de rastreamento.
O Windows WF (Workflow Foundation) no .NET Framework 4.6.1 fornece um participante de rastreamento que grava os registros de rastreamento em uma sessão de ETW. O participante é configurado em um serviço de fluxo de trabalho adicionando um comportamento acompanhamento- específico em um arquivo de configuração. Ativar um participante de rastreamento de ETW permite controlar os registros a serem exibidos no visualizador de eventos. O exemplo SDK para o rastreamento ETW- base é uma boa maneira para obter o familiarizado com rastreamento de WF usando o participante controlando ETW- base.
Participante de rastreamento de ETW
O .NET Framework 4.6.1 inclui um participante de rastreamento de ETW que grava os registros de rastreamento a uma sessão de ETW. Isso é feito em uma maneira muito eficiente com um impacto mínimo o desempenho do aplicativo ou à produção de servidor. Uma vantagem de usar o participante de acompanhamento de ETW padrão é que os registros que o controle receba podem ser exibidos com o outro aplicativo e o sistema entra no visualizador de eventos do Windows.
O participante de rastreamento do padrão ETW é configurado no arquivo web.config conforme mostrado no exemplo o seguir.
<configuration>
<system.web>
<compilation debug="true" targetFramework="4.0" />
</system.web>
<system.serviceModel>
<behaviors>
<serviceBehaviors>
<behavior>
<etwTracking profileName="Sample Tracking Profile"/>
</behavior>
</serviceBehaviors>
</behaviors>
<tracking>
<profiles>
<trackingProfile name="Sample Tracking Profile">
….
</trackingProfile>
</profiles>
</tracking>
</system.serviceModel>
</configuration>
Observação
Se um nome de trackingProfile não for especificado, como apenas <etwTracking/> ou <etwTracking profileName=""/>, então o perfil padrão de rastreamento instalado com o .NET Framework 4.6.1 no arquivo Machine.config é usado.
No arquivo Machine.config, o perfil padrão de rastreamento assina os registros e a falhas de instância de fluxo de trabalho.
Em ETW, os eventos são gravados para a sessão de ETW com uma identificação do provedor O provedor que o ID que o participante de rastreamento de ETW usa gravar o rastreamento registra a ETW é definido na seção de diagnóstico do arquivo web.config (em <system.serviceModel><diagnostics>). Por padrão, o participante de rastreamento de ETW usa um padrão de identificação do provedor quando se não foi especificado, conforme mostrado no exemplo o seguir.
<system.serviceModel>
<diagnostics etwProviderId="52A3165D-4AD9-405C-B1E8-7D9A257EAC9F" />
A ilustração a seguir mostra o fluxo de dados de rastreamento através de participante de rastreamento de ETW. Uma vez que os dados de acompanhamento alcançam a sessão de ETW, podem ser acessados de várias maneiras. Uma das maneiras mais úteis de acessar esses eventos é através do visualizador de eventos, uma ferramenta do Windows comuns usada exibindo efetua logon e rastreamentos de aplicativos e serviços.
Dados do evento de participante de rastreamento
Um participante de rastreamento serializa dados controlados de evento a uma sessão de ETW no formato de um evento pelo registro de rastreamento. Um evento é identificado usando um identificador dentro do intervalo de 100 a 199. Para definições de registros de evento de rastreamento emissores por um participante de rastreamento, confira o tópico Referência de Eventos de Rastreamento.
O tamanho de um evento de ETW é limitado pelo tamanho do buffer de ETW, ou pela carga útil máximo para um evento de ETW, qualquer valor é menor. Se o tamanho do evento excede qualquer um desses limites de ETW, o evento será truncado e seu conteúdo é removido de uma maneira arbitrária. Variáveis, os argumentos, anotações e os dados personalizado não são removidos seletivamente. No caso de truncamento, todos estes é truncada independentemente do valor que fez com que o tamanho do evento excede o limite de ETW. Os dados são removidos substituídos por <item>..<item>.
Os tipos complexos em variáveis, nos argumentos e, em itens de dados personalizados são serializados para o registro de evento de ETW usando a classe NetDataContractSerializer. Essa classe inclui informações de CLR- tipo no vapor serializado XML.
Truncamento de dados de carregamento útil devido aos limites de ETW pode resultar em duplicado através dos registros que estão sendo enviados a uma sessão de ETW. Isso pode ocorrer se mais de uma sessão é escutando eventos e as sessões têm diferentes limites de carregamento útil para os eventos.
Para a sessão com o limite inferior o evento pode ser truncado. O participante de rastreamento de ETW não tem conhecimento do número de sessões que escutam por eventos; se um evento é truncado para uma sessão no participante de ETW tentar de volta para o evento uma vez. Nesse caso a sessão que está configurada para aceitar um tamanho maior de carregamento útil obterá o evento duas vezes (o evento não truncado e truncado). Duplicação pode ser impedida configurando todas as sessões de ETW com os mesmos limites de tamanho do buffer.
Acessando dados de acompanhamento de um participante de ETW no visualizador de eventos
Os eventos que são gravados em uma sessão de ETW por participante de rastreamento de ETW podem ser acessados através do visualizador de eventos (para usar o padrão de identificação do provedor). Isso permite rapidamente exibindo os registros de rastreamento que foram emitidos pelo fluxo de trabalho.
Observação
Controlando o registro os eventos emissores a uma sessão de ETW usam IDs de evento no intervalo de 100 a 199.
Para ativar exibir os registros de rastreamento no visualizador de eventos
Ligue o visualizador de eventos (EVENTVWR.EXE)
Selecione Visualizador de Eventos, Aplicativos e Logs de Serviço da Microsoft, o Windows, Aplicativos do Servidor de Aplicativo.
Clique com o botão direito do mouse para selecionar Exibição, Mostrar Análise e Logs de depuração. Se não, selecione-o para que a marca de seleção aparece próxima a ela. Isso exibe os logs Análise, Perf e Depurar.
Clique com o botão direito do mouse no log de Análise e selecione Habilitar Log. O log existirá no diretório %SystemRoot% \ arquivo de Winevt System32 \ \ \ application logs Server-Applications%4Analytic.etl.
Participante de rastreamento personalizada
O participante de rastreamento API permite a extensão de rastreamento usuário fornecido com o participante de rastreamento que pode incluir a lógica personalizada para manipular os registros de rastreamento emissores em runtime de fluxo de trabalho. Para gravar um participante personalizado de rastreamento, o desenvolvedor deve implementar o método Track na classe de TrackingParticipant . Este método é chamado quando um registro de rastreamento é emitida em runtime de fluxo de trabalho.
Os participantes de rastreamento derivam da classe de TrackingParticipant . Sistema forneceu EtwTrackingParticipant emite-se um rastreamento de evento para o evento do Windows (ETW) para cada registro de rastreamento que é recebido. Para criar um participante personalizado de rastreamento, uma classe é criada que deriva de TrackingParticipant. Para fornecer funcionalidade básica de rastreamento, substitua Track. Track é chamado quando um registro de rastreamento é enviado pelo runtime e pode ser processado da maneira desejada. No exemplo a seguir, uma classe personalizada de participante de rastreamento é definida que emite todos os registros de rastreamento para a janela do console. Você também pode implementar um objeto de TrackingParticipant que processa os registros de rastreamento que usam de forma assíncrona seus métodos de BeginTrack e de EndTrack
class ConsoleTrackingParticipant : TrackingParticipant
{
protected override void Track(TrackingRecord record, TimeSpan timeout)
{
if (record != null)
{
Console.WriteLine("=================================");
Console.WriteLine(record);
}
}
}
Para usar um participante específico de rastreamento, registrá-lo com a instância de fluxo de trabalho que você deseja controlar, conforme mostrado no exemplo o seguir.
myInstance.Extensions.Add(new ConsoleTrackingParticipant());
No exemplo a seguir, um fluxo de trabalho que consiste uma atividade de Sequence que contém uma atividade de WriteLine é criado. ConsoleTrackingParticipant é adicionado para extensões e fluxo de trabalho é chamado.
Activity activity= new Sequence()
{
Activities =
{
new WriteLine()
{
Text = "Hello World."
}
}
};
WorkflowApplication instance = new WorkflowApplication(activity);
instance.Extensions.Add(new ConsoleTrackingParticipant());
instance.Completed = delegate(WorkflowApplicationCompletedEventArgs e)
{
Console.WriteLine("workflow instance completed, Id = " + instance.Id);
resetEvent.Set();
};
instance.Run();
Console.ReadLine();
