Seguimiento personalizado

En el ejemplo de CustomTracking, se muestra cómo crear un participante de seguimiento personalizado y cómo escribir en la consola el contenido de los datos de seguimiento. Además, el ejemplo muestra cómo emitir objetos CustomTrackingRecord rellenados con datos definidos por el usuario. El participante de seguimiento basado en consola filtra los objetos TrackingRecord que emite el flujo de trabajo utilizando un objeto de perfil de seguimiento creado en código.

Detalles del ejemplo

Windows Workflow Foundation (WF) proporciona una infraestructura de seguimiento para realizar el seguimiento de la ejecución de una instancia de flujo de trabajo. El tiempo de ejecución de seguimiento implementa una instancia de flujo de trabajo para emitir eventos relacionados con el ciclo de vida de flujo de trabajo, eventos procedentes de actividades de flujo de trabajo y eventos de seguimiento personalizados. En la siguiente tabla se detallan los componentes primarios de la infraestructura de seguimiento.

En la siguiente tabla se detallan los registros de seguimiento que emite el tiempo de ejecución del flujo de trabajo.

El participante de seguimiento se suscribe a un subconjunto de los objetos TrackingRecord emitidos utilizando perfiles de seguimiento. Un perfil de seguimiento contiene consultas de seguimiento que permiten suscribirse a un tipo de registro de seguimiento concreto. Los perfiles de seguimiento se pueden especificar mediante código o en la configuración.

Participante de seguimiento personalizado

La API de participante de seguimiento permite la ampliación del tiempo de ejecución de seguimiento mediante un participante de seguimiento proporcionado por el usuario que puede incluir una lógica personalizada para controlar los objetos TrackingRecord emitidos por el tiempo de ejecución de flujo de trabajo.

Para escribir un participante de seguimiento, el usuario debe implementar TrackingParticipant. Concretamente, el participante personalizado debe implementar el método Track. Se llama a este método cuando el tiempo de ejecución de flujo de trabajo emite un registro TrackingRecord.

public abstract class TrackingParticipant
{
    protected TrackingParticipant();

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

El participante de seguimiento completo se implementa en el archivo ConsoleTrackingParticipant.cs. El ejemplo de código siguiente es el método Track para el participante de seguimiento 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();

}

El siguiente ejemplo de código agrega el participante de la consola al invocador de flujo de trabajo.

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

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

Emitir registros de seguimiento personalizados

En este ejemplo también se muestra la capacidad de emitir objetos CustomTrackingRecord desde una actividad de flujo de trabajo personalizada:

• Los objetos CustomTrackingRecord se crean y rellenan con datos definidos por el usuario que se desean emitir con el registro.

• CustomTrackingRecord se emite mediante una llamada al método de seguimiento de ActivityContext.

En el siguiente ejemplo se muestra cómo emitir objetos CustomTrackingRecord desde una actividad personalizada.

// 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 utilizar este ejemplo

1. Con Visual Studio, abra el archivo de solución CustomTrackingSample.sln.

2. Para compilar la solución, presione Ctrl+MAYÚS+B.

3. Para ejecutar la solución, presione CTRL+F5.

Consulte también

• Ejemplos de supervisión de AppFabric