Rastreamento personalizada

Artigo
05/10/2023

A amostra de Acompanhamento Personalizado demonstra como criar um participante de acompanhamento personalizado e gravar o conteúdo dos dados de acompanhamento no console. Além disso, o exemplo demonstra como emitir os objetos de CustomTrackingRecord preenchido com dados definidos pelo usuário. O participante controlando console- base filtra os objetos de TrackingRecord emissores pelo fluxo de trabalho usando um objeto de perfil de rastreamento criado em código.

Detalhes de exemplo

A Windows Workflow Foundation (WF) fornece uma infraestrutura de acompanhamento para a execução de acompanhamento de uma instância de fluxo de trabalho. O runtime de rastreamento implementa uma instância de fluxo de trabalho para emitir os eventos relacionados ao ciclo de vida de fluxo de trabalho, os eventos de atividades de fluxo de trabalho e eventos personalizados de rastreamento. A tabela a seguir detalha os componentes principais de infraestrutura de rastreamento.

Componente	Descrição
runtime de rastreamento	Fornece a infraestrutura para emitir registros de rastreamento.
Participantes de rastreamento	Consome os registros de rastreamento. O .NET Framework 4 é fornecido com um participante de acompanhamento que grava registros de acompanhamento como eventos de Rastreamento de Eventos para Windows (ETW).
Controlando o perfil	Um mecanismo de filtragem que permite que um participante de rastreamento assine para um subconjunto de registros de rastreamento emissores de uma instância de fluxo de trabalho.

A tabela a seguir detalha os registros de rastreamento que o runtime de fluxo de trabalho se emite.

Registro de Rastreamento	Descrição
Registros de rastreamento de instância de fluxo de trabalho.	Descreve o ciclo de vida de instância de fluxo de trabalho. Por exemplo, um registro de instância é emitida quando o fluxo de trabalho inicia ou termina.
Estado da atividade que acompanha registros.	Detalha a execução da atividade. Esses registros indicam o estado de uma atividade de fluxo de trabalho como quando uma atividade é agendada ou quando a atividade completa ou quando uma falha é lançada.
Registro de ressunção do indexador.	Emitido sempre que um marcador em uma instância de fluxo de trabalho que é.
Registros personalizados de rastreamento.	Um autor de fluxo de trabalho pode criar registros personalizados de rastreamento e emitir os dentro da atividade personalizado.

O participante de rastreamento assinatura para um subconjunto dos objetos emissores de TrackingRecord usando perfis de rastreamento. Um perfil de rastreamento contém consultas de rastreamento que permitem assinar para um tipo de registro específico de rastreamento. Controlar perfis pode ser especificado no código ou na configuração.

Participante de rastreamento personalizada

O participante API de rastreamento permite a extensão de rastreamento com um usuário fornecido pelo participante que pode incluir a lógica personalizada para manipular os objetos de TrackingRecord emissores em runtime de fluxo de trabalho.

Para gravar um participante de rastreamento o usuário deve implementar TrackingParticipant. Especificamente, o método de Track precisa ser implementado por participante personalizado. Este método é chamado quando TrackingRecord é emitida em runtime de fluxo de trabalho.

public abstract class TrackingParticipant
{
    protected TrackingParticipant();

    public virtual TrackingProfile TrackingProfile { get; set; }
    public abstract void Track(TrackingRecord record, TimeSpan timeout);
}

O participante de acompanhamento completo é implementado no arquivo ConsoleTrackingParticipant.cs. O exemplo de código a seguir é o método Track para o participante de acompanhamento personalizado.

protected override void Track(TrackingRecord record, TimeSpan timeout)
{
    ...
    WorkflowInstanceRecord workflowInstanceRecord = record as WorkflowInstanceRecord;
    if (workflowInstanceRecord != null)
    {
        Console.WriteLine(String.Format(CultureInfo.InvariantCulture,
            " Workflow InstanceID: {0} Workflow instance state: {1}",
            record.InstanceId, workflowInstanceRecord.State));
    }

    ActivityStateRecord activityStateRecord = record as ActivityStateRecord;
    if (activityStateRecord != null)
    {
        IDictionary<String, object> variables = activityStateRecord.Variables;
        StringBuilder vars = new StringBuilder();

        if (variables.Count > 0)
        {
            vars.AppendLine("\n\tVariables:");
            foreach (KeyValuePair<string, object> variable in variables)
            {
                vars.AppendLine(String.Format(
                    "\t\tName: {0} Value: {1}", variable.Key, variable.Value));
            }
        }
        Console.WriteLine(String.Format(CultureInfo.InvariantCulture,
            " :Activity DisplayName: {0} :ActivityInstanceState: {1} {2}",
                activityStateRecord.Activity.Name, activityStateRecord.State,
            ((variables.Count > 0) ? vars.ToString() : String.Empty)));
    }

    CustomTrackingRecord customTrackingRecord = record as CustomTrackingRecord;

    if ((customTrackingRecord != null) && (customTrackingRecord.Data.Count > 0))
    {
        ...
    }
    Console.WriteLine();

}

O exemplo de código a seguir adiciona o participante de console para o solicitante de fluxo de trabalho.

ConsoleTrackingParticipant customTrackingParticipant = new ConsoleTrackingParticipant()
{
    ...
    // The tracking profile is set here, refer to Program.CS
...
}

WorkflowInvoker invoker = new WorkflowInvoker(BuildSampleWorkflow());
invoker.Extensions.Add(customTrackingParticipant);

Emitindo registros de rastreamento personalizadas

Este exemplo também demonstra a capacidade de emitir objetos de CustomTrackingRecord de uma atividade personalizado de fluxo de trabalho:

Os objetos de CustomTrackingRecord são criados e preenchido com dados definidos pelo usuário que são desejados ser emitidos com o registro.
A CustomTrackingRecord é emitida chamando o método de rastreamento do ActivityContext.

O exemplo a seguir demonstra como emitir objetos de CustomTrackingRecord dentro de uma atividade personalizado.

// Create the Custom Tracking Record
CustomTrackingRecord customRecord = new CustomTrackingRecord("OrderIn")
{
    Data =
    {
        {"OrderId", 200},
        {"OrderDate", "20 Aug 2001"}
    }
};

// Emit custom tracking record
context.Track(customRecord);

Para usar este exemplo

Usando o Visual Studio, abra o arquivo de solução CustomTrackingSample.sln.
Para criar a solução, pressione CTRL+SHIFT+B.
Para executar a solução, pressione CTRL+F5.

Confira também

AppFabric que monitora Exemplos

Compartilhar via