工作流可以通过三种方式执行:
作为 WorkflowApplication 执行
使用 WorkflowInvoker 直接执行
根据工作流托管选项,可以通过代码或通过配置文件添加跟踪参与者。 本主题说明如何通过向 a WorkflowApplication 和 a WorkflowServiceHost添加跟踪参与者来配置跟踪,以及如何在使用 WorkflowInvoker时启用跟踪。
配置工作流应用程序跟踪
可以使用 WorkflowApplication 类来运行工作流。 本主题演示了如何为 .NET Framework 4.6.1 工作流应用程序配置跟踪,具体方法是将跟踪参与者添加到 WorkflowApplication 工作流主机。 在这种情况下,工作流作为工作流应用程序运行。 可以通过代码(而不是使用配置文件)配置工作流应用程序,该文件是使用该 WorkflowApplication 类的自承载 .exe 文件。 跟踪参与者被添加为 WorkflowApplication 实例对象的扩展。 将 TrackingParticipant 添加到 WorkflowApplication 实例的扩展集合中。
对于工作流应用程序,可以添加 EtwTrackingParticipant 行为扩展,如以下代码所示。
LogActivity activity = new LogActivity();
WorkflowApplication instance = new WorkflowApplication(activity);
EtwTrackingParticipant trackingParticipant =
new EtwTrackingParticipant
{
TrackingProfile = new TrackingProfile
{
Name = "SampleTrackingProfile",
ActivityDefinitionId = "ProcessOrder",
Queries = new WorkflowInstanceQuery
{
States = { "*" }
}
}
};
instance.Extensions.Add(trackingParticipant);
配置工作流服务跟踪
在 WorkflowServiceHost 服务主机中托管时,工作流可以被公开为 WCF 服务。 WorkflowServiceHost 是基于工作流的服务的专用 .NET ServiceHost 实现。 本部分介绍如何为运行中的 WorkflowServiceHost.NET Framework 4.6.1 工作流服务配置跟踪。 它可以通过 Web.config 文件(用于 Web 托管服务)或 App.config 文件(用于在独立应用程序中托管的服务,例如控制台应用程序)来配置,这可以通过指定服务行为来实现。此外,还可以通过代码将特定于跟踪的行为添加到 Behaviors 服务主机的集合中来进行配置。
对于托管在 WorkflowServiceHost 中的工作流服务,可以在配置文件中使用 EtwTrackingParticipant<behavior
元素添加 >,如下示例所示。
<behaviors>
<serviceBehaviors>
<behavior>
<etwTracking profileName="Sample Tracking Profile" />
</behavior>
</serviceBehaviors>
</behaviors>
或者,对于托管在 WorkflowServiceHost 环境中的工作流服务,你可以通过代码添加 EtwTrackingParticipant 行为扩展。 若要添加自定义跟踪参与者,请创建新的行为扩展,并将其添加到 ServiceHost 以下示例代码中所示。
注释
如果要查看演示如何创建自定义行为元素(添加自定义跟踪参与者)的示例代码,请参阅 跟踪 示例。
ServiceHost svcHost = new ServiceHost(typeof(WorkflowService), new
Uri("http://localhost:8001/Sample"));
EtwTrackingBehavior trackingBehavior =
new EtwTrackingBehavior
{
ProfileName = "Sample Tracking Profile"
};
svcHost.Description.Behaviors.Add(trackingBehavior);
svcHost.Open();
跟踪参与者将作为行为的扩展添加到工作流服务主机中。
以下示例代码演示如何从配置文件读取跟踪信息。
TrackingProfile GetProfile(string profileName, string displayName)
{
TrackingProfile trackingProfile = null;
TrackingSection trackingSection = (TrackingSection)WebConfigurationManager.GetSection("system.serviceModel/tracking");
if (trackingSection == null)
{
return null;
}
profileName ??= "";
//Find the profile with the specified profile name in the list of profile found in config
var match = from p in new List<TrackingProfile>(trackingSection.TrackingProfiles)
where (p.Name == profileName) && ((p.ActivityDefinitionId == displayName) || (p.ActivityDefinitionId == "*"))
select p;
if (match.Count() == 0)
{
//return an empty profile
trackingProfile = new TrackingProfile()
{
ActivityDefinitionId = displayName
};
}
else
{
trackingProfile = match.First();
}
return trackingProfile;
此代码示例演示如何向工作流主机添加跟踪配置文件。
WorkflowServiceHost workflowServiceHost = serviceHostBase as WorkflowServiceHost;
if (null != workflowServiceHost)
{
string workflowDisplayName = workflowServiceHost.Activity.DisplayName;
TrackingProfile trackingProfile = GetProfile(this.profileName, workflowDisplayName);
workflowServiceHost.WorkflowExtensions.Add(() => new EtwTrackingParticipant {
TrackingProfile = trackingProfile
});
}
注释
有关跟踪配置的详细信息,请参阅跟踪配置文件。
使用 WorkflowInvoker 配置跟踪
若要配置使用WorkflowInvoker执行的工作流的跟踪,请将跟踪提供程序作为扩展添加到WorkflowInvoker实例。 下面的代码示例来自 自定义跟踪 示例。
WorkflowInvoker invoker = new WorkflowInvoker(BuildSampleWorkflow());
invoker.Extensions.Add(customTrackingParticipant);
invoker.Invoke();
在事件查看器中查看跟踪记录
跟踪 WF 执行时,有两个特别感兴趣的事件查看器日志 - 分析日志和调试日志。 两者都位于 Microsoft | Windows | 应用程序 Server-Applications 节点之下。 本部分中的日志包含来自单个应用程序的事件,而不是对整个系统产生影响的事件。
调试跟踪事件将写入调试日志。 若要在事件查看器中收集 WF 调试跟踪事件,请启用调试日志。
若要打开事件查看器,请单击“ 开始”,然后单击“ 运行”。 在“运行”对话框中,键入
eventvwr
。在“事件查看器”对话框中,展开 “应用程序和服务日志 ”节点。
展开 Microsoft、 Windows 和 应用程序服务器应用程序 节点。
右键单击“应用程序服务器-应用程序”节点下的“调试”节点,然后选择“启用日志”。
执行已启用跟踪的应用程序以生成跟踪事件。
右键单击 “调试” 节点,然后选择“ 刷新”。 跟踪事件应在中心窗格中可见。
WF 4 提供一个跟踪参与者,用于将跟踪记录写入 ETW (Windows 事件跟踪)会话。 ETW 跟踪参与者通过跟踪配置文件配置为订阅跟踪记录。 启用跟踪后,错误跟踪记录将发送到 ETW。 与 ETW 跟踪参与者发出的跟踪事件相对应的 ETW 跟踪事件(范围介于 100 到 113 之间)将写入分析日志。
若要查看跟踪记录,请执行以下步骤。
若要打开事件查看器,请单击“ 开始”,然后单击“ 运行”。 在“运行”对话框中,键入
eventvwr
。在“事件查看器”对话框中,展开 “应用程序和服务日志 ”节点。
展开 Microsoft、 Windows 和 应用程序服务器应用程序 节点。
右键单击“应用程序服务器-应用程序”节点下的“分析”节点,然后选择“启用日志”。
执行已启用跟踪的应用程序以生成跟踪记录。
右键单击 “分析 ”节点,然后选择“ 刷新”。 跟踪记录应显示在中心窗格中。
下图显示了事件查看器中的跟踪事件:
注册应用程序特定的提供程序 ID
如果需要将事件写入特定应用程序日志,请按照以下步骤注册新的提供程序清单。
在应用程序配置文件中声明提供程序 ID。
<system.serviceModel> <diagnostics etwProviderId="2720e974-9fe9-477a-bb60-81fe3bf91eec"/> </system.serviceModel>
将清单文件从 %windir%\Microsoft.NET\Framework\<latest version of .NET Framework 4.6.1>\Microsoft.Windows.ApplicationServer.Applications.man 复制到临时位置,并将其重命名为 Microsoft.Windows.ApplicationServer.Applications_Provider1.man
将清单文件中的 GUID 更改为新的 GUID。
<provider name="Microsoft-Windows-Application Server-Applications" guid="{2720e974-9fe9-477a-bb60-81fe3bf91eec}" />
如果不想卸载默认提供程序,请更改提供程序名称。
<provider name="Microsoft-Windows-Application Server-Applications" guid="{2720e974-9fe9-477a-bb60-81fe3bf91eec}" />
如果在上一步中更改了提供程序名称,请将清单文件中的通道名称更改为新的提供程序名称。
<channel name="Microsoft-Windows-Application Server-Applications_Provider1/Admin" chid="ADMIN_CHANNEL" symbol="ADMIN_CHANNEL" type="Admin" enabled="false" isolation="Application" message="$(string.MICROSOFT_WINDOWS_APPLICATIONSERVER_APPLICATIONS.channel.ADMIN_CHANNEL.message)" /> <channel name="Microsoft-Windows-Application Server-Applications_Provider1/Operational" chid="OPERATIONAL_CHANNEL" symbol="OPERATIONAL_CHANNEL" type="Operational" enabled="false" isolation="Application" message="$(string.MICROSOFT_WINDOWS_APPLICATIONSERVER_APPLICATIONS.channel.OPERATIONAL_CHANNEL.message)" /> <channel name="Microsoft-Windows-Application Server-Applications_Provider1/Analytic" chid="ANALYTIC_CHANNEL" symbol="ANALYTIC_CHANNEL" type="Analytic" enabled="false" isolation="Application" message="$(string.MICROSOFT_WINDOWS_APPLICATIONSERVER_APPLICATIONS.channel.ANALYTIC_CHANNEL.message)" /> <channel name="Microsoft-Windows-Application Server-Applications_Provider1/Debug" chid="DEBUG_CHANNEL" symbol="DEBUG_CHANNEL" type="Debug" enabled="false" isolation="Application" message="$(string.MICROSOFT_WINDOWS_APPLICATIONSERVER_APPLICATIONS.channel.DEBUG_CHANNEL.message)" /> <channel name="Microsoft-Windows-Application Server-Applications_Provider1/Perf" chid="PERF_CHANNEL" symbol="PERF_CHANNEL" type="Analytic" enabled="false" isolation="Application" message="$(string.MICROSOFT_WINDOWS_APPLICATIONSERVER_APPLICATIONS.channel.PERF_CHANNEL.message)" />
按照以下步骤生成资源 DLL。
在 Windows SDK 命令提示符中,在新清单文件上运行 mc.exe。
mc.exe Microsoft.Windows.ApplicationServer.Applications_Provider1.man
对上一步生成的资源文件运行 rc.exe。
rc.exe Microsoft.Windows.ApplicationServer.Applications_Provider1.rc
创建名为 NewProviderReg.cs 的空 cs 文件。
使用 C# 编译器创建资源 DLL。
csc /target:library /win32res:Microsoft.Windows.ApplicationServer.Applications_Provider1.res NewProviderReg.cs /out:Microsoft.Windows.ApplicationServer.Applications_Provider1.dll
将清单文件中的资源和消息 dll 名称从
Microsoft.Windows.ApplicationServer.Applications.Provider1.man
更改为新的 dll 名称。<provider name="Microsoft-Windows-Application Server-Applications_Provider1" guid="{2720e974-9fe9-477a-bb60-81fe3bf91eec}" symbol="Microsoft_Windows_ApplicationServer_ApplicationEvents" resourceFileName="<dll directory>\Microsoft.Windows.ApplicationServer.Applications_Provider1.dll" messageFileName="<dll directory>\Microsoft.Windows.ApplicationServer.Applications_Provider1.dll" />
使用 wevtutil 注册清单。
wevtutil im Microsoft.Windows.ApplicationServer.Applications_Provider1.man