ライフサイクル ワークフローの履歴

  • [アーティクル]

ライフサイクル ワークフローを使用して作成されたワークフローを利用すると、組織内の ID ライフサイクルの Joiner-Mover-Leaver (JML) モデル内のどこに該当する場合でも、ユーザーのライフサイクル タスクを自動化できます。 ワークフローが正しく処理されるようにすることは、組織のライフサイクル管理プロセスの重要な部分です。 ワークフローが正しく処理されないと、セキュリティとコンプライアンスに関する多くの問題が発生するおそれがあります。 ライフサイクル ワークフローの履歴機能を使用すると、ユーザー、実行、またはタスクの概要に基づいて、履歴を表示するワークフロー イベントを指定できます。 このレポート機能を使用すると、誰に対して何が実行されたか、およびそれが成功したかどうかをすばやく確認できます。 これらの特定の領域の概要と共に、記録された各特定イベントに関する詳細情報をそれぞれのセクションで表示することもできます。 また、これらのレポートを CSV ファイルとしてダウンロードすることもできます。 この記事では、組織内のユーザーにワークフローがどのように利用されたかについての詳細を取得する際、どのようなときにこれらの各機能を使うかについて説明します。 テナント全体のワークフロー情報の集約については、ライフサイクル ワークフロー分析情報 (プレビュー) に関する記事をご覧ください。 ライフサイクル ワークフローで実行するすべてのアクションの詳細については、「ライフサイクル ワークフローの監査」を参照してください。

ライフサイクル ワークフローの履歴の概要

ライフサイクル ワークフローでは、概要と詳細に基づく履歴機能が導入されています。 これらの履歴の概要を使用すると、ワークフローの実行対象のユーザーと、この実行が成功したかどうかに関する情報をすばやく取得できます。 これが重要なのは、監査ログによって提供される大量の情報セットが多くなりすぎて、効率的に使用できなくなる可能性があるためです。 この大量に処理される情報セットを読みやすくするため、ライフサイクル ワークフローには手軽に利用できる概要が用意されています。 これらの履歴の概要は、3 つの方法で表示できます。

  • ユーザーの概要: ワークフローによって処理されたユーザーの概要を表示します。 成功、失敗、合計実行数の情報が特定のユーザーごとに表示されます。
  • 実行の概要: ワークフローの実行の概要をワークフローの観点から表示します。 ワークフローの実行時に、成功した、失敗した、完全に実行されたタスクの情報が記録されます。
  • タスクの概要: ワークフローによって処理されたタスクの概要と、ワークフロー内の失敗した、成功した、完全に実行されたタスクが表示されます。

概要を利用すると、ログの詳細に進まずに、ワークフローがそれ自体またはユーザーに関してどのように実行されたかに関する詳細をすばやく取得できます。 この情報を取得するためのステップ バイ ステップ ガイドについては、「ワークフローの状態を確認する」を参照してください。

ユーザーの概要情報

ユーザーの概要を利用すると、処理されたユーザーの観点でワークフローの情報を表示できます。

ワークフローのユーザーの概要のスクリーンショット。

ユーザーの概要内では、次の情報を見つけることができます。

パラメーター 説明
Total Processed (処理された合計) 選択した期間中にワークフローによって処理されたユーザーの合計数。
成功 選択した期間中にワークフローによって処理された、成功したユーザーの合計数。
失敗 選択した期間中にワークフローによって処理された、失敗したユーザーの合計数。
合計タスク数 選択した期間中にワークフローでユーザーに対して処理されたタスクの合計数。
失敗したタスク 選択した期間中にワークフローでユーザーに対して処理された、失敗したタスクの合計数。

ユーザー履歴の詳細

ユーザーの詳細な履歴情報を使用すると、以下に基づいて特定の情報をフィルター処理できます。

  • 日付: ワークフローが実行されたときの特定の範囲 (最短で 24 時間から最長で 30 日間まで) をフィルター処理できます。
  • 状態: 処理されたユーザーの特定の状態をフィルター処理できます。 サポートされている状態は、[完了]、[進行中]、[キューに挿入済み]、[キャンセル済み]、[完了済み (エラーあり)]、[失敗] です。
  • ワークフローの実行タイプ: [スケジュール設定] や [要求時] など、ワークフローの実行の種類でフィルター処理できます
  • 完了日: ユーザーがワークフローで処理されたときの特定の範囲 (最短 24 時間から最長で 30 日まで)をフィルター処理できます。

ユーザー履歴の状態の詳細

ユーザー処理履歴の状態を表示する場合、状態の値は次の情報に対応します。

Status 詳細
完了 この状態は、ワークフローのすべてのタスクがユーザーに対して正常に処理された場合に報告されます。
進行中 この状態は、ワークフローがユーザーのタスクの実行を開始したときに報告されます。 ユーザーに対してワークフローのすべてのタスクが処理されるか、失敗するまで、ステータスはこの状態のままになります。
キュー登録済み この状態は、ワークフローの実行条件を満たすライフサイクル ワークフロー エンジンによってユーザーが識別されたときに報告されます。 ここから、ユーザーは、ユーザーに対してワークフローが実行を開始した場合は "進行中" の状態になり、管理者がワークフローを手動で取り消した場合はキャンセルの状態になります。
取り消し済み この状態は、次の理由で報告されます。

1.ワークフローが削除された場合、実行するように設定されているすべてのスケジュールされたユーザーが取り消されます。
2.ワークフローが無効になっている場合、実行するように設定されているすべてのスケジュールされたユーザーが取り消されます。
3.ワークフローのスケジュールが無効になっている場合、実行するように設定されているすべてのスケジュールされたユーザーが取り消されます。
4.ワークフローに新しいバージョンが作成され、すべてのタスクが無効になっている場合、実行するように設定されているすべてのスケジュールされたユーザーが取り消されます。
5.ユーザーがワークフローの新しいバージョンの現在の実行条件を満たしていない場合、スケジュールされた実行が取り消されます。
6.ユーザーがワークフローを実行するためにキューに登録されていたが、実行直前にプロファイルが変更され、ワークフローの現在の実行条件を満たさなくなった場合、処理は取り消されます。
完了 (エラーあり) この状態は、ワークフローは完了したが、ContinueOnError が true に設定されている 1 つ以上のタスクが失敗した場合に報告されます。
Failed この状態は、continueOnError が false に設定されているタスクが失敗した場合に報告されます。

処理されたユーザーの概要情報の取得に関する詳細なガイドについては、「Microsoft Entra 管理センターを使用したユーザー ワークフローの履歴」を参照してください。

実行の概要

実行の概要を利用すると、その実行履歴の観点でワークフローの情報を表示できます。

ワークフローの実行の概要のスクリーンショット。

実行の概要内では、次の情報を見つけることができます。

パラメーター 説明
Total Processed (処理された合計) 実行されたワークフローの合計数。
成功 正常に実行されたワークフロー。
失敗 実行に失敗したワークフロー。
失敗したタスク 実行され、タスクが失敗したワークフロー。

実行履歴の詳細

実行の詳細な履歴情報を使用すると、以下に基づいて特定の情報をフィルター処理できます。

  • 日付: ワークフローが実行されたときの特定の範囲 (最短で 24 時間から最長で 30 日間まで) をフィルター処理できます。
  • 状態: 実行されたワークフローの特定の状態をフィルター処理できます。 サポートされている状態は、[完了]、[進行中]、[キューに挿入済み]、[キャンセル済み]、[完了済み (エラーあり)]、[失敗] です。
  • ワークフローの実行タイプ: [スケジュール設定] や [要求時] など、ワークフローの実行の種類でフィルター処理できます。
  • 完了日: ワークフローが実行されたときの特定の範囲 (最短で 24 時間から最長で 30 日間まで) をフィルター処理できます。

実行履歴の状態の詳細

実行履歴の状態を表示する場合、状態の値は次の情報に対応します。

Status 詳細
キュー登録済み この状態は、ワークフローが初めて実行するように設定されたときに報告されます。
処理中 この状態は、ワークフローが最初のタスクの処理を開始するとすぐに報告されます。
取り消し済み この状態は、ある時点で "進行中" だったが、現在はその状態で凍結されている場合に報告されます。
完了 (エラーあり) この状態は、ワークフローが一部に対して正常に実行されたが、その他に対しては正常に実行されなかった場合に報告されます。 ワークフローがキュー状態に入っても、そのすべてのインスタンスが実行前にキャンセルされた場合、"進行中" の状態になる前にこの状態が表示されます。
完了 この状態は、ワークフローがすべてのユーザーに対して正常に実行された場合に報告されます。
Failed この状態は、ワークフローの実行対象であるすべてのユーザーに対してすべてのタスクが失敗した場合に報告されます。 レポートでは、取り消されたユーザーはエラーとしてカウントされません。

実行に関する情報を取得する方法の詳細なガイドについては、「Microsoft Entra 管理センターを使用したワークフロー実行履歴」を参照してください。

タスクの概要

タスクの概要を利用すると、そのタスクの観点でワークフローの情報を表示できます。

ワークフロー タスクの概要のスクリーンショット。

タスクの概要内では、次の情報を見つけることができます。

パラメーター 説明
Total Processed (処理された合計) ワークフローによって処理されたタスクの合計数。
成功 ワークフローによって正常に処理されたタスクの数。
失敗 ワークフローによって処理され、失敗したタスクの数。
未処理 ワークフローによって処理されなかったタスクの数。

タスク履歴の詳細

タスクの詳細な履歴情報を使用すると、以下に基づいて特定の情報をフィルター処理できます。

  • 日付: ワークフローが実行されたときの特定の範囲 (最短で 24 時間から最長で 30 日間まで) をフィルター処理できます。
  • 状態: 実行されたワークフローの特定の状態をフィルター処理できます。 サポートされている状態は、[完了]、[進行中]、[キューに挿入済み]、[キャンセル済み]、[完了済み (エラーあり)]、[失敗] です。
  • 完了日: ワークフローが実行されたときの特定の範囲 (最短で 24 時間から最長で 30 日間まで) をフィルター処理できます。
  • タスク: 特定のタスク名に基づいてフィルター処理できます。

タスク履歴の状態の詳細

タスク履歴の状態を表示する場合、状態の値は次の情報に対応します。

Status 詳細
キュー登録済み この状態は、ワークフロー インスタンスの実行がスケジュールされると報告されます。ワークフロー内のすべてのタスクのタスク レポートも、この状態で実行レコードと共に作成されます。 各タスク レポートにはすべてのユーザーが含まれますが、特定のタスクを表します。
処理中 この状態は、最初のタスクの処理が開始されるとすぐに報告されます。
取り消し済み この状態は、ワークフローが取り消される前に処理されたタスクがない場合に報告されます。 タスクを含むワークフローが削除されると、状態もキャンセルと表示されます。
完了 (エラーあり) この状態は、ユーザーに対してタスクが処理されたが、必ずしもすべてのタスクが成功していない場合に報告されます。
完了 この状態は、すべてのユーザーに対してすべてのタスクが正常に実行された場合に報告されます。
Failed この状態は、すべてのタスクが失敗した場合に報告されます。

ワークフローの処理とタスクを分離することが重要です。1 つのワークフロー内で、ユーザーの処理時に特定のタスクが成功し、他のものが失敗する場合があるためです。 ワークフローで失敗したタスクの後にタスクを実行するかどうかは、[エラー時に続行する] を有効にするといったパラメーターと、ワークフロー内でのそれらの配置によって決まります。 詳細については、タスクの共通パラメーターに関するページを参照してください。

次のステップ