フロー実行の詳細

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:11分
  • 現在のステータス、実行されたアイテム、生成された値など、設計環境からアクションまたはフローに関するランタイム情報を直接表示します。埋め込まれた Now 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 トリガー MetricBase トリガー条件が メトリックベース 満たされました。
    サービスカタログ トリガー サービスカタログアイテムが要求されたときにフローが開始されました。
    スクリプト ビジネスルールなど、スクリプト内のメソッド呼び出しからフローが開始されました。
    バックグラウンド スクリプト [スクリプト - バックグラウンド] モジュール内のメソッド呼び出しからフローが開始されました。

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

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

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

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

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

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

    サブフロー実行の詳細

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

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