Execution Monitoring

Track workflow executions in real-time, review audit trails, and analyze workflow performance.

Execution Monitor Panel

The Execution Monitor shows all workflow runs for the current workflow.

Accessing the Monitor

1. Open a workflow in the builder
2. Click the Executions tab or panel
3. View list of recent executions

Execution List

Each execution shows:

Field	Description
ID	Unique execution identifier
Status	pending, in_progress, completed, failed, cancelled
Applicant	Associated applicant name/ID
Started	Execution start timestamp
Duration	Time to complete
Outcome	Final result: approved, rejected, review

Real-Time Updates

Executions update in real-time via WebSocket:

• Node entered - Active node highlights
• Node completed - Status updates
• Condition evaluated - Branch taken shown
• Execution completed - Final outcome

Execution Details

Click any execution to view details:

Step History

Chronological list of steps:

14:30:01  Started execution
14:30:02  → Entered: ID Document
14:30:15  ✓ Completed: ID Document (13s)
14:30:16  → Entered: Selfie Verification
14:30:28  ✓ Completed: Selfie Verification (12s)
14:30:29  → Entered: Run Screening
14:30:31  ✓ Completed: Run Screening (2s)
14:30:32  → Entered: Risk Check
14:30:32  ⋈ Condition: risk_score_above(50) = false
14:30:32  → Branch: Low Risk Path
14:30:33  ✓ Completed: Auto Approve
14:30:33  ○ Execution completed: approved

Action Results

View results from each action node:

Run Screening:

{
  "has_hits": false,
  "hit_count": 0,
  "lists_checked": ["ofac_sdn", "un_consolidated", "eu_sanctions"],
  "match_scores": []
}

Verify Document:

{
  "document_type": "passport",
  "name_match": true,
  "dob_match": true,
  "expiry_valid": true,
  "fraud_signals": [],
  "confidence": 0.94
}

Compliance Explanation

The monitor shows why each decision was made:

Decision Rationale:

• Document verification passed with 94% confidence
• No sanctions hits found across 3 lists
• Risk score (32) below threshold (50)
• Auto-approval criteria met per workflow rules

This helps compliance officers and auditors understand automated decisions.

Collected Data

Data gathered during execution:

• Document images (redacted preview)
• Extracted OCR data
• Selfie photos
• Form responses
• Device fingerprint

Audit Trail

Event Types

Event	Description
execution_started	Workflow began
node_entered	Entered a node
action_completed	Action finished
condition_evaluated	Condition checked
branch_taken	Path decision made
execution_completed	Workflow finished
execution_failed	Error occurred
execution_cancelled	Manually cancelled

Pagination

For long executions, events are paginated:

• Default: 20 events shown
• Click Load More or Show All for full history
• Events sorted newest first

Export

Export audit trail for compliance:

1. Click Export in execution details
2. Choose format (CSV, JSON, PDF)
3. Download includes all events and results

Analytics

Execution Metrics

Metric	Description
Total Executions	Count of workflow runs
Success Rate	% completed successfully
Avg Duration	Mean execution time
Approval Rate	% resulting in approval
Manual Review Rate	% routed to review

Time Series

View metrics over time:

• Executions per day/week/month
• Duration trends
• Outcome distribution

Bottleneck Analysis

Identify slow steps:

• Average time per node
• Nodes with highest variance
• Failed node frequency

Filtering

Filter executions by:

Filter	Options
Status	pending, in_progress, completed, failed
Outcome	approved, rejected, review, pending
Date Range	Start and end dates
Applicant	Search by name or ID
Duration	Min/max execution time

API Access

List Executions

curl -X GET "https://api.bytrustgate.com/v1/workflow-builder/executions?workflow_id={id}" \
  -H "Authorization: Bearer YOUR_API_KEY"

Get Execution

curl -X GET "https://api.bytrustgate.com/v1/workflow-builder/executions/{execution_id}" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:

{
  "id": "exec_123",
  "workflow_id": "wf_456",
  "applicant_id": "app_789",
  "status": "completed",
  "final_outcome": "approved",
  "step_history": [
    {
      "node_id": "start-1",
      "status": "completed",
      "entered_at": "2026-01-25T14:30:01Z",
      "completed_at": "2026-01-25T14:30:01Z"
    }
  ],
  "action_results": {
    "screening-1": {
      "has_hits": false,
      "hit_count": 0
    }
  },
  "created_at": "2026-01-25T14:30:01Z",
  "completed_at": "2026-01-25T14:30:33Z"
}

Get Execution Events

curl -X GET "https://api.bytrustgate.com/v1/workflow-builder/executions/{id}/events" \
  -H "Authorization: Bearer YOUR_API_KEY"

WebSocket Subscription

Connect to receive real-time updates:

const ws = new WebSocket('wss://api.bytrustgate.com/ws?token=YOUR_JWT');

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);

  switch(data.type) {
    case 'workflow.node.entered':
      // Highlight node on canvas
      break;
    case 'workflow.node.completed':
      // Update node status
      break;
    case 'workflow.execution.completed':
      // Show final outcome
      break;
  }
};

Troubleshooting

Execution Stuck

If execution appears stuck:

1. Check execution status - may be waiting for manual step
2. Check applicant data - missing required fields
3. Check workflow config - node may have invalid config
4. Check service health - external service may be down

Execution Failed

If execution failed:

1. View error message in execution details
2. Check failed node - usually indicates which step
3. Review logs for detailed error
4. Common causes:
   • Invalid applicant data
   • External service timeout
   • Configuration error
   • Rate limit exceeded

Re-Running Execution

To re-run a failed workflow:

1. Fix the underlying issue
2. Navigate to applicant details
3. Click Run Workflow or trigger manually via API

---

Next Steps

• Creating Workflows - Build workflows
• Node Types - Configure nodes properly
• API Reference - Full API documentation