追跡レコード

2011-02-24

このトピックの内容は、Windows Workflow Foundation 4 に該当します。

ワークフローランタイムは、ワークフローインスタンスの実行状況を追跡する追跡レコードを出力するためにインストルメント化されています。

追跡レコード

次の表で、ワークフローランタイムが出力する追跡レコードの詳細を説明します。

追跡レコード	説明
ワークフローライフサイクルレコード	ワークフローインスタンスのライフサイクルの多様なステージ中に出力されます。たとえば、ワークフローの開始時または完了時にレコードは出力されます。
アクティビティライフサイクルレコード	アクティビティの実行状況を詳しく記録します。これらのレコードは、アクティビティをスケジュールしたとき、アクティビティが完了したとき、エラーが発生したときなど、ワークフローアクティビティの状態を示します。
ブックマーク再開レコード	ワークフローインスタンス内のブックマークが再開されたときに出力されます。
カスタム追跡レコード	ワークフロー作成者はカスタム追跡レコードを作成し、カスタムアクティビティ内で出力できます。

WF ランタイムから出力されるすべての追跡関連レコードは、基本クラス TrackingRecord から派生します。この基本クラスには一般的なデータのセットが含まれます。追跡レコードは、単純なワークフローのライフサイクルを示します。各追跡レコードには、InstanceId、RecordNumber などの関連する追跡イベント、および追跡レコードの型に固有の追加情報の詳細が含まれます。

次の TrackingRecord オブジェクトの型は、ワークフローランタイムによって出力されます。

WorkflowInstanceRecord - この TrackingRecord は、ワークフローインスタンスのライフサイクルを示します。たとえば、ワークフローの開始時または完了時にレコードが出力されます。また、レコードにはワークフローインスタンスの状態が含まれます。このレコードの詳細については、「WorkflowInstanceRecord」を参照してください。
WorkflowInstanceAbortedRecord - この TrackingRecord は、ワークフローインスタンスの中止時に出力されます。レコードにはワークフローインスタンスが中止された理由が含まれます。このレコードの詳細については、「WorkflowInstanceAbortedRecord」を参照してください。
WorkflowInstanceUnhandledExceptionRecord - この TrackingRecord は、例外がワークフローインスタンスで発生し、任意のアクティビティによって処理されない場合に出力されます。レコードには例外の詳細が含まれます。このレコードの詳細については、「WorkflowInstanceUnhandledExceptionRecord」を参照してください。
WorkflowInstanceSuspendedRecord - この TrackingRecord は、ワークフローインスタンスが一時停止されたときに出力されます。レコードにはワークフローインスタンスが一時停止された理由が含まれます。このレコードの詳細については、「WorkflowInstanceSuspendedRecord」を参照してください。
WorkflowInstanceTerminatedRecord - この TrackingRecord は、ワークフローインスタンスが終了したときに出力されます。レコードにはワークフローインスタンスが終了した理由が含まれます。このレコードの詳細については、「WorkflowInstanceTerminatedRecord」を参照してください。
ActivityStateRecord - この TrackingRecord は、ワークフロー内のアクティビティが実行されたときに出力されます。これらのレコードは、ワークフローインスタンス内のアクティビティの状態を示します。このレコードの詳細については、「ActivityStateRecord」を参照してください。
ActivityScheduledRecord - この TrackingRecord は、アクティビティが子のアクティビティをスケジュールするときに出力されます。このレコードには、親のアクティビティ (スケジューリングアクティビティ) およびスケジュール設定された子のアクティビティの両方の詳細が含まれます。このレコードの詳細については、「ActivityScheduledRecord」を参照してください。
FaultPropagationRecord - この TrackingRecord は、レコードが処理されるまで、レコードを確認するハンドラーごとに出力されます。これは、エラーがワークフローインスタンス内でたどるパスを示すために使用されます。このレコードの詳細については、「FaultPropagationRecord」を参照してください。
CancelRequestedRecord - この TrackingRecord は、アクティビティが子のアクティビティを取り消そうとするときに出力されます。このレコードには、親のアクティビティおよび取り消される子のアクティビティの両方の詳細が含まれます。このレコードの詳細については、「CancelRequestedRecord」を参照してください。
BookmarkResumptionRecord - この TrackingRecord は、正常に再開されるすべてのブックマークを追跡します。このレコードの詳細については、「BookmarkResumptionRecord」を参照してください。
CustomTrackingRecord - この TrackingRecord は、カスタムワークフローアクティビティ内のワークフロー作成者によって作成および出力されます。カスタム追跡レコードには、レコードと一緒に出力されるデータを読み込むことができます。このレコードの詳細については、「CustomTrackingRecord」を参照してください。

たとえば、WriteLine 操作と次の順序で出力された追跡レコードを含む単純な Sequence アクティビティもあります。

WorkflowInstanceRecord は、ワークフローが起動していることを示します。
ActivityScheduledRecord は、アクティビティがスケジュールされたことを示します。この場合は Sequence アクティビティです。
ActivityScheduledRecord は、WriteLine アクティビティを表します。
2 つのアクティビティが完了していることを示す 2 つの ActivityStateRecord レコードがあります。
WorkflowInstanceRecord は、ワークフローが完了していることを示します。

カスタム追跡レコードの出力

次の例に示すように、カスタム追跡レコードはコードアクティビティから出力できます。

protected override void Execute(CodeActivityContext context)
{
…
            CustomTrackingRecord customRecord = new CustomTrackingRecord("CustomEmailSentEvent");
            customRecord.Data.Add("SendTime", sendTime);
            context.Track(customRecord);
}

ActvityContext 上で Track メソッドを呼び出すことで、CustomTrackingRecord をコードアクティビティに出力できます。

次の方法で共有

追跡レコード

追跡レコード

カスタム追跡レコードの出力

その他のリソース