monitor-executions

Monitor Executions Skill

This skill provides execution monitoring and data extraction for n8n workflows.

When to Use

• Waiting for workflow execution to complete
• Extracting output data from executions
• Debugging failed executions
• Monitoring execution patterns
• Batch cleanup of old executions

Core Methods

Wait for Completion

Wait for an execution to finish with polling:

const result = await executionHelper.waitForCompletion(
  executionId,    // Execution ID (number)
  60,             // Timeout in seconds (default: 60)
  1               // Poll interval in seconds (default: 1)
)

Result structure:

interface WaitResult {
  success: boolean
  executionId: string
  status: 'success' | 'error' | 'waiting' | 'timeout'
  data?: unknown        // Output data if successful
  error?: string        // Error message if failed
  duration?: number     // Execution duration in seconds
}

Extract Output Data

Get output from the last node of an execution:

const output = await executionHelper.getOutput(executionId)

Result structure:

interface ExecutionOutput {
  success: boolean
  data?: unknown       // Output data from last node
  error?: string
  nodeName?: string    // Name of the last executed node
}

Get Error Message

Extract error message from a failed execution:

const errorMessage = await executionHelper.getError(executionId)
// Returns: string | null

Check Execution Status

// Check if still running
const running = await executionHelper.isRunning(executionId)
// Returns: boolean

// Get status string
const status = await executionHelper.getStatus(executionId)
// Returns: 'success' | 'error' | 'waiting' | 'unknown'

Listing Executions

List Failed Executions

const failures = await executionHelper.listFailed(
  workflowId,   // Optional: filter by workflow
  10            // Limit (default: 10)
)

Returns:

Array<{
  id: number
  workflowId: number
  startedAt: string
  error?: string
}>