ワークフローのトラブルシューティング
ワークフローの実行をすばやくトラブルシューティングして、問題を特定し、必要な変更を評価し、ワークフローを再稼働させます。
ワークフローをトラブルシューティングするには、次の手順に従います。
ワークフローの実行結果を確認する
ダッシュボード上部のワークフローの Outcome summary で次を確認します。
Outcomes タブには、Workflow 実行が到達した可能な終了結果である
action_taken、no_action_taken、failed、otherごとの件数が表示されます。「Details」タブには、Workflow 実行中に収集された
{dynamic values}によって決定される、ユーザー定義の結果詳細が含まれます。 結果の詳細を構成する方法については、エンドステート を参照してください。
さらに、Executions の総数と、それぞれの Completion status：Success、Failed、In progress、Cancelled、Expired を確認します。 設定されたダッシュボードの期間に対するチャートを使用して、これらの Workflow 実行を可視化します。
Workflow 実行の完了ステータスを判定する
Workflow 実行の詳細を示した表を確認します：
Request time：Workflow 実行がトリガーされた日時。
Completion status：Workflow 実行の現在の状態―Success、Failed、In progress、Cancelled、Expired。
**Outcome：**Workflow 実行が到達した終了結果のいずれか：
action_taken、no_action_taken、failed、other。Device → Name：ローカルネットワーク識別のためにオペレーティングシステムによって認識されるデバイス名。
Username：ローカルデバイス上のユーザーアカウント名。
**Trigger method：**Manual、Schedule、API、Events。 Workflow トリガータイプの詳細については、ワークフローのトリガー を参照してください。
Execution Duration：実行開始から完了までの時間。
Completion status が Success の場合、Workflow が End state に到達したことを示します。 つまり、完全な実行パスです。
ただし、成功した Workflow 実行であっても、Workflow 内のすべての Thinklet が意図した結果を必ずしも達成しているとは限りません。Thinklet のエラーがあっても、Workflow 実行が停止しない場合があります。
特定の Thinklet の失敗を追跡および報告するには、Workflow に End state Flow コントロールを追加してください。 エンドステート を参照して、これらの結果チェックポイントを構成します。
タイムラインを使用して Workflow 実行をトラブルシュートする
表から、対象となる特定の Workflow 実行を選択すると、右側のパネルに実行タイムラインが表示されます。 この方法で、実行イベントとアクションの時系列の流れを追跡できます。
最新のワークフローステップは常にタイムラインの上部に表示されます。 ワークフローが期待される結果から逸れた場所を特定します。
Workflow 実行タイムラインは、Workflow 実行が終了してから 3 日間のみ利用できます。
Workflow 実行タイムラインでは、ステップが実行されたかどうかは表示されますが、関係するサードパーティシステムの Completion status は示されません。
たとえば、Workflow の Service\API Thinklet がサードパーティシステムを呼び出し、200 (OK) 応答を受け取った場合、応答内容にサードパーティ側の内部エラーが含まれていても、Workflow は実行を成功とマークします。
Workflow アクションの詳細を確認する
実行タイムライン内の特定のアクションをクリックして、そのアクションの状態を詳しく調査します。 ポップアップが表示され、さらに詳細が確認できます。
システムは、Workflow タイムラインに登録されたアクションまたはイベントに関連付けられた Thinklet に応じて、実行の詳細を表示します。
Remote action Thinklet の実行詳細
リモートアクションThinkletの詳細を確認する際に、以下の情報が利用可能です。
開始時間: システムがThinkletの処理を開始した日時。
終了時間: システムがThinkletの処理を終了した日時。
ステータスの詳細: エラーが発生した場合のみ表示され、リモートアクションで発生した障害を説明するメッセージが含まれます。
パラメータ: このリモートアクションで使用されたパラメータがある場合に表示されます。 パラメータの内容がここに表示されます。
出力: リモートアクションによって収集された出力がある場合に表示されます。 出力の内容がここに表示されます。
Campaign Thinklet の実行詳細
キャンペーンThinkletの詳細を確認する際に、以下の情報が利用可能です。
開始時間: システムがThinkletの処理を開始した日時。
終了時間: システムがThinkletの処理を終了した日時。
状態の詳細: エラーが発生した場合のみ表示され、キャンペーンからのメッセージとして障害を説明する可能性があります。
パラメータ: このキャンペーンで使用されたパラメータがある場合に表示されます。 パラメータの内容がここに表示されます。
出力: キャンペーンのために収集された回答がある場所に表示されます。 出力の内容がここに表示されます。
Service\API Thinklet の実行詳細
サービス\API Thinkletアクションの詳細を確認する際に、以下の情報が利用可能です。
開始時間: システムがThinkletの処理を開始した日時。
終了時間: システムがThinkletの処理を終了した日時。
レスポンスHTTPコード: 3rdパーティAPIから取得したレスポンスです。
HTTPメソッド: 3rdパーティAPIが使用したHTTPメソッドです。
リソースパス: 呼び出しが送信される3rdパーティAPIのリソースパスのエンドポイント。
ペイロード: システムが3rdパーティAPIに行った呼び出しの本文です。
大きなペイロードの場合、ペイロードにカーソルを合わせると、ツールチップでフルデータセットが表示されます。
出力: このThinkletのために出力を設定した場合、それに収集されたデータがここに表示されます。
Connector Thinklet の実行詳細
コネクターシンクレットアクションの詳細を確認する際、コネクターで使用するAPIレスポンスの詳細を以下の情報で得ることができます。
開始時間: システムがThinkletの処理を開始した日時。
終了時間: システムがThinkletの処理を終了した日時。
レスポンスHTTPコード: 3rdパーティAPIから取得したレスポンスです。
HTTPメソッド: 3rdパーティAPIが使用したHTTPメソッドです。
リソースパス: 呼び出しが送信される3rdパーティAPIのリソースパスのエンドポイント。
ペイロード: システムがサードパーティAPIに作成した呼び出しの本文。
大きなペイロードの場合、ペイロードにカーソルを合わせると、ツールチップでフルデータセットが表示されます。
出力: Thinkletのために設定された出力がある場合、それに収集されたデータがここに表示されます。
Update custom fields Thinklet の実行詳細
ワークフロー監視のタイムラインで カスタムフィールドを更新 thinklet の結果を確認する際、次の詳細が利用可能です:
ステータス: Thinklet 実行が成功したか失敗したかを示します。
時間: Thinklet が実行された日時。
オブジェクト: Thinklet 設定で選択されたオブジェクトの種類: デバイス または ユーザー。
ターゲット: 更新に関与した特定のユーザーまたはデバイス識別子。 例えば、デバイスID。
更新済み: 正常に更新されたカスタムフィールドを一覧表示:
カスタムフィールド名: 更新されたフィールドの名前。
値: カスタムフィールドに書き込まれた値。
未更新—失敗した場合のみ表示:
カスタムフィールド名: 更新に失敗したカスタムフィールド。
値: 書き込む予定だった値。
エラー: 失敗の理由。 例：カスタムフィールドの更新に失敗しました。
特定の Thinklet の失敗を追跡および報告するには、Workflow に End state Flow コントロールを追加してください。 エンドステート を参照して、これらの結果チェックポイントを構成します。
Workflow トラブルシューティングに関する F.A.Q
Workflow トラブルシューティングに関する一般的な質問を解消します。
一部のワークフロー手順が失敗したにもかかわらず、システムがワークフローの実行を成功とマークするのはなぜですか？
システムは、Workflow が End state、つまり完全な実行パスに到達すると、実行を Success とマークします。 ただし、成功した実行であっても、すべての Workflow Thinklet が意図した結果を達成しているとは限りません。 一部の Thinklet エラーは Workflow 実行を停止せず、実行が完了まで継続する場合があります。
このような失敗を識別して報告するには、Workflow 内に End state Flow コントロールを追加して、Thinklet 固有の結果を記録および公開します。 エンドステート を参照して、これらの結果チェックポイントを構成します。
最終更新
役に立ちましたか？