フロー実行の詳細

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：13分

    • 現在のステータス、実行されたアイテム、生成された値など、設計環境からアクションまたはフローに関するランタイム情報を直接表示します。埋め込まれた ServiceNow AI Platform エディターまたは新しいタブから関連レコードを開きます。

    フローをテストするたびに、フロー実行の詳細として生成された構成値とランタイム値に関する情報が生成されます。フロー実行の詳細は、ワークフロースタジオ の [操作] タブから表示できます。関連する実行の詳細ページを開くには、フロー実行を選択します。

    図 : 1. 今日の実行に関するフロー実行の詳細の例
    今日の実行に関するフロー実行の詳細のリスト。
    各実行の詳細ページには、フローに関するランタイム情報が表示されます。
    • フローの名前
    • フローデータをリフレッシュ
    • フロー状態
    • 関連レコードのオプション
    • フロー統計情報
    図 : 2. 実行の詳細の例
    実行の詳細の例

    レポートレベル

    レポートレベルは、通常の操作中にフロー、サブフロー、またはアクションが生成する実行の詳細を決定します。デフォルトでは、 ワークフロースタジオ は通常の操作中に実行の詳細を生成しません。 ワークフロースタジオ は、個々のフロー、サブフロー、またはアクションをテストするときに、完全なフロー実行の詳細を生成します。インスタンスがより多くの実行の詳細を生成して保存すると、レポートによって、インスタンスに対するより大きなパフォーマンス上の影響が生じます。

    各レポートレベルでは、さらにフロー実行の詳細が段階的に生成されます。

    オフ
    フロー実行の詳細は生成されません。テストの実行時にのみ、実行の詳細が生成されます。
    注:
    アクションまたはフローをテストすると、トレースレベルで実行の詳細が生成されます。
    基本：ランタイム状況と期間のみ
    フロー、サブフロー、およびアクションが実行されるたびに、ランタイム実行の詳細が生成されます。これらの基本的なアイテムについて、ランタイムステータスと期間を確認できます。また、フロートリガー、サブフロー入力、サブフロー出力について、構成とランタイム値の確認もできます。
    完全：アクションの構成とランタイム値 (デバッグのみ)
    フロー、サブフロー、アクションが実行されるたびに、構成とランタイム実行の詳細が生成されます。すべてのアイテムについて、ランタイムステータス、期間、入力値、および出力値を確認できます。カスタムアクションの場合は、ステップのランタイムステータス、期間、入力値、および出力値を確認できます。また、フロートリガー、サブフロー、アクション、およびカスタムアクションの一部になっているステップについて、構成値の確認もできます。
    重要:
    fd_read_operations_all ロールを持つユーザーのみが、フロー実行の詳細でレコード値などの構成およびランタイム情報を表示できます。このロールを持たないユーザーには、ステータスと期間に関する基本的な詳細のみが表示されます。
    トレース：すべての値 (テストとサポートのみ)
    フロー、サブフロー、アクション、およびステップが実行されるたびに、構成とランタイム実行の詳細が生成されます。すべてのアイテムについて、ランタイムステータス、期間、入力値、および出力値を確認できます。また、フロートリガー、サブフロー、アクション、およびステップについて、構成値の確認もできます。
    重要:
    fd_read_operations_all ロールを持つユーザーのみが、フロー実行の詳細でレコード値などの構成およびランタイム情報を表示できます。このロールを持たないユーザーには、ステータスと期間に関する基本的な詳細のみが表示されます。アクションまたはフローをテストすると、トレースレベルで実行の詳細が生成されます。

    レポートがオフになっている場合にフローが実行されると、レポートレベルが後で変更されても、フローの過去の実行の詳細は使用できません。レポートがオンのときにフローが実行されると、レポートレベルが変更されても、そのフローの実行の詳細を使用できます。レポートレベルはコンテキストおよびログレコードには影響しません。

    フローが実行されるたびに実行の詳細の生成に使用されるデフォルトのレポートレベルを設定できます。詳細については、「フローのレポートの有効化」を参照してください。

    フローデータをリフレッシュ

    必要に応じてフローのランタイムデータを更新します。フロー設定を、テストの実行時にフローデータを自動的に更新するように設定します。「フローのユーザー設定」を参照してください。

    フロー状態

    すべての有効なフローは次のいずれかの状況になります。

    完了
    フローはすべてのアクションを正常に実行しました。フロー統計情報には、各アクションの構成とランタイムの詳細が表示されます。
    キャンセル
    フローの実行時間がフローのタイムアウト値を超えたためにフローが停止したか、誰かが手動でフローをキャンセルしました。
    待機中
    続行する前に条件が満たされるのを待っているアクションで、フローが一時停止しました。フロー統計情報には、完了したアクションと、条件が満たされるのを待機しているアクションの構成とランタイムの詳細が表示されます。待機状態でのフローでは、ヘッダーに [フローのキャンセル] UI アクションが表示されます。
    一時停止
    優先度の高いフローの実行または正常なノードのシャットダウンを可能にするために、フローが一時停止されました。フロー統計情報には、完了したアクションの構成とランタイムの詳細が表示されます。
    中断と推定
    フローが 15 分以上実行されていて、現在のノードに有効なトランザクション ID がなくなりました。または、フローが別のノードで 8 時間を超えて実行されています。トランザクションの終了やノードの再起動などの予期しない中断が原因で、フローが停止した可能性があります。
    エラー
    フローはエラーで停止しました。フロー統計情報には、完了したアクションの構成とランタイムの詳細、およびエラーを生成したアクションの構成の詳細が表示されます。エラー状態のフローでは、ヘッダーに [エラーに移動] UI アクションが表示されます。
    注:
    アクションによってエラーが発生すると、フローはその時点で実行を停止し、エラーステータスになります。

    関連レコードのオプション

    [実行の詳細] ページから、現在のフローに関連するレコードにアクセスできます。

    フローを開く
    構成を変更してフローの新しいインスタンスを公開するには、このオプションを使用します。フローの構成を変更しても、現在有効なフローは変更されません。
    コンテキストレコードを開く
    標準のフォーム ビューから、フロー状態、実行時間、および関連するログ エントリーを表示するには、このオプションを使用します。このオプションでは、新しいタブにコンテキスト レコードが開きます。
    フロー ログを開く
    各アクションに関する詳細なログ情報を表示するには、このリンクを使用します。このリンクをクリックすると、新しいタブにログ エントリーの一覧が表示されます。
    現在のレコードを開く
    レコードベースのトリガーを持つフローの場合は、このリンクを使用して、ポップアップ ウィンドウにトリガーとなるレコードを表示します。
    アクションを開く
    このリンクを使用して、構成の変更を行い、アクションの新しいインスタンスを公開します。アクションの構成を変更しても、現在有効なフローは変更されません。ServiceNow が提供するコアアクションでは、このリンクは利用できません。

    フロー統計情報

    フロー統計情報を使用して、各フローコンポーネントの構成の詳細とランタイム値を確認します。トリガーまたはアクションを選択すると、行が展開され、その行に関する構成とランタイムの詳細が表示されます。

    図 : 3. フロー統計情報の例
    フロー統計情報の例

    次のタイプの実行の詳細が利用できます。

    コール ソース
    フロー、サブフロー、またはアクションを開始したコールソースを表示します。
    実行方法
    フローの [実行方法] が、システムなのか、フローをトリガーしたユーザーなのかを識別します。
    実行するロール
    フローをトリガーしたユーザーに付与されたロールを識別します。
    統合メタデータ
    使用している接続と資格情報、使用している MID サーバー、ターゲットホスト、ペイロードサイズなどのトランザクションデータを表示します。データ連携メタデータは統合ステップでのみ表示されます。また、統合ハブ のサブスクリプションが別途必要です。詳細については、「統合ステップ」を参照してください。
    構成詳細
    入力変数のリストを表示して、アクションの構成エラーを特定します。各変数には、名前、データタイプ、構成設定、およびランタイム値を表示する独自の行があります。構成設定では、動的な値がピルとして表示されます。ランタイム値は、生成されたレコードをリンクとして表示します。
    注:
    変換関数を持つ変数は、すべての変換の結果であるランタイム値を 1 つだけ表示します。
    出力データ
    出力変数のリストを表示して、アクションの構成エラーを特定します。
    ログ
    ログ エントリーを使用して、処理やパフォーマンスの潜在的な問題を特定します。各ログ エントリーには、作成日、ログ レベル、およびログ メッセージを表示する独自の行があります。アクションによってログが生成されない場合、統計情報には「ログがありません」という文字列が表示されます。
    注:
    ログは UTC 形式で表示されます。これは、インスタンスが複数のノード間でログデータを共有できるように、ログを文字列として保存する必要があるためです。各ノードは異なるタイムゾーンに存在する可能性があるため、正しい時間値を保持するための共通形式として UTC 形式が使用されます。
    ステップ

    ステップのリストを使用して、アクションの構成エラーを特定します。各ステップには、変数名、データタイプ、構成設定、およびランタイム値を表示する独自の行があります。コアアクションについては、構成を変更できないため、ステップが表示されません。

    com.snc.process_flow.reporting.serialized.val_size_limit システムプロパティを変更して、フロー実行の詳細のステップ構成でランタイム値を切り捨てます。詳細については、「ワークフロースタジオ フローシステムプロパティ」を参照してください。

    開始時間
    アクションが開始された現地時間を表示します。
    実行期間
    実行時間を使用して、処理やパフォーマンスの潜在的な問題を特定します。実行時間はミリ秒単位で測定されます。Washington DC リリースの時点では、実行時間にはアイテム実行の合計時間が一覧表示されます。合計時間には、以下のアイテムが含まれます。
    • イベントキュー内の時間
    • ECC キュー内の時間
    • イベントの処理時間
    • フローエンジンでの実行時間
    • MID サーバーとの通信時間
    再試行情報
    [再試行情報] セクションを使用して、再試行ポリシーの詳細を確認します。詳細には、再試行戦略のタイプ、経過時間、次のスケジュールされた再試行要求が含まれます。[再試行情報] セクションは、ステップで再試行ポリシーが有効になっている場合にのみ表示されます。詳細については、「再試行ポリシー」を参照してください。

    コール ソース

    コールソースには、フロー、サブフロー、またはアクションの開始元が一覧表示されます。

    ソース 説明
    ワークフロースタジオ のテスト 誰かがワークフロースタジオのインターフェイスから [テスト] オプションを選択したためにフローが開始されました。フローのトリガー条件は無視されました。
    CRUD トリガー レコードベースのトリガー条件が満たされたときにフローが開始されました。
    日付トリガー スケジュールベースのトリガー条件が満たされたときにフローが開始されました。
    Metric トリガー フローが開始されたタイミング メトリックベーストリガー条件 メトリックベース が満たされました。
    サービスカタログ トリガー サービスカタログアイテムが要求されたときにフローが開始されました。
    スクリプト ビジネスルールなど、スクリプト内のメソッド呼び出しからフローが開始されました。
    バックグラウンド スクリプト [スクリプト - バックグラウンド] モジュール内のメソッド呼び出しからフローが開始されました。

    埋め込みテキスト ビューアー

    ワークフロースタジオ 埋め込みテキストビューアーを使用して、メール出力、XML ペイロード、スクリプトステップなどの大規模なテキストベースの構成およびランタイム出力レコードを表示します。埋め込みテキスト ビューアーでは、テキストを HTML、プレーン テキスト、または色分けされた JavaScript として書式設定できます。スクリプト ステップについては、テキスト ビューアーではエラーを含むコード行が強調表示されます。

    図 : 4. スクリプト ステップのテキスト表示の例
    サンプルスクリプト

    フロー ロジックの各アイテムの結果の表示

    ワークフロースタジオ では、フローロジックによって処理された各アイテムの構成とランタイム結果を表示するセレクターコントロールが表示されます。レコード番号を選択すると、その構成と実行時の詳細が表示されます。

    図 : 5. フローロジックの各アイテムのサンプルフロー統計情報
    For Each フローロジック

    サブフロー実行の詳細

    プロセスアナリストは、複数の場所からサブフロー実行の詳細を表示できます。

    親フロー
    親フローは、インライン要素として呼び出される各サブフローのフロー実行の詳細をリストします。サブフローのステップを展開して、サブフロー実行の詳細を表示します。
    サブフロー
    サブフローが実行されるたびにフロー実行の詳細が生成されます。フロー実行のリストからサブフロー実行の詳細を直接表示します。

    ユーザーロールのサポート

    ユーザーロールを付与することで、フロー実行の詳細へのアクセスを制御できます。利用可能な ワークフロースタジオ ユーザーロールの詳細については、「 ワークフロースタジオ フローへのユーザーアクセス」を参照してください。

    表 : 1. ワークフロースタジオ 実行の詳細のロール
    ロールタイトル [名前] 説明 ロールを含む
    flow_operator フロー実行の詳細、ダッシュボード、およびログを表示できます。アドミニストレーターは、実行結果を表示することはできるが、実行結果の作成、変更、テストは行わないユーザーに対して、このロールを付与できます。 なし
    fd_read_operation 基本フローとアクションの実行の詳細を表示できます。レポートが有効になっている場合、このロールを持つユーザーは、ランタイムの状況や期間などの基本的な実行の詳細のみを表示できます。レポートレベルで追加の詳細が生成された場合、このロールを持つユーザーはそれらを表示できません。アドミニストレーターは、基本的な実行の結果を表示する必要はあるがフローおよびアクションの作成、変更、テストは行わないユーザーに対して、このロールを付与できます。
    注:
    読み取り専用ロールは、書き込みアクセスを提供するロールと互換性がありません。同じユーザーに読み取り専用アクセスロールと書き込みアクセスロールの両方を付与することは避けてください。
    		 なし
    fd_read_operations_all 生成されたすべてのフローとアクションの実行の詳細を表示できます。レポートが有効になっている場合、このロールを持つユーザーは利用可能なすべての実行の詳細を表示できます。ユーザーは、レポートレベルのシステムプロパティで定義されている詳細のみを表示できます。アドミニストレーターは、すべてのフローの結果を表示する必要はあるがフローおよびアクションの作成、変更、テストは行わないユーザーに対して、このロールを付与できます。
    注:
    読み取り専用ロールは、書き込みアクセスを提供するロールと互換性がありません。同じユーザーに読み取り専用アクセスロールと書き込みアクセスロールの両方を付与することは避けてください。
    		 fd_read_operation

    ロールを使用して実行のサポート

    フローが 1 つ以上の特権ロールで実行されている場合、フロー実行の詳細を表示するには、ユーザーがこれらの特権ロールも持っている必要があります。たとえば、フローがシステムとして実行されている場合、そのフロー実行の詳細を表示するには、ユーザーに admin ロールが必要です。さらに、フィールド暗号化にアクセスできるロールでフローが実行されている場合、フロー実行の詳細を表示するには、ユーザーがそのロールも持っている必要があります。フィールド暗号化とロールの詳細については、「 Field Encryption」を参照してください。