Processor Reordering Feature Documentation
Overview
Normally when a processor is created, it gets added to the end of the execution order. The Processor Reordering feature allows users to change the execution order of processors within a destination pipeline. Processors are executed sequentially in the order they appear, so reordering them can significantly impact data processing behavior.ℹ️ Why Reordering Matters
Reordering lets you optimize cost and/or latency without redeploying collectors. Changes both persist immediately and propagate to live traffic.
Key Concepts
- Processors execute in sequential order (top to bottom)
- Robust Algorithm Only changes processors you’ve moved, maintains stable ordering
- Real-time Updates changes apply immediately to live data
- Audit Logging tracks all reordering operations with before/after states
User Guide
How to Reorder Processors (UI)
1. Open the Reorder Drawer
- Navigate to the Processors list
- Find the destination you want to reorder processors for
- Click the “Reorder” button for that destination or you can click Reorder Processor from a processor’s Action menu
- A drawer will slide in from the right showing all processors for that destination
2. Reorder Using Drag & Drop
- Drag Handle: Click and hold the ⋮⋮ icon on the left of any processor
- Drag: Move the processor up or down to the desired position. The page will scroll automatically if you drag near the top or bottom of the list.
- Drop: Release to place it in the new position
3. Reorder Using Move Buttons
- Move to Top ⇈ - Jump to first position
- Move Up ⇑ - Move up one position
- Move Down ⇓ - Move down one position
- Move to Bottom ⇊ - Jump to last position
- Visual Feedback: The row will pulse/highlight when successfully moved
4. Save Changes
- Cancel button - Discards all changes and closes drawer
- Save button - Opens confirmation modal
- Confirm - Applies changes immediately to live data
- Changes are visible immediately across the platform
Activity Log
Every reorder triggers an activity log entry you can review in the Audit Log UI. What you’ll see:- Before order: full list of processors in their original positions.
- After order: the updated list immediately after you save.
- Moves summary: only the processors that changed position, showing the old and new index.
- Metadata: pipeline, destination, who made the change, and when it happened.