Plug Database Socket Event Trigger icon

Plug Database Socket Event Trigger

Starts a workflow when a Plug Database socket event is received.

Plug Database Socket Event Trigger

AI-generated

Summary

Listen for real-time Plug socket events of specified types (agent profile updates or custom events) and emit n8n workflow items when those events occur.

Inputs

  • Event Source (required) — Select the type of Plug Socket event to listen for: either 'Agent Profile Updated' events or 'Custom Events'.
  • Event Names — When listening for 'Custom Events', specify one or more exact custom event names to subscribe to; wildcards are not supported.
  • Subscription ACK Timeout (MS) — Maximum time in milliseconds to wait for socket connection and event control acknowledgements (default 10000).
  • Consumer Idle Keepalive (MS) — Interval in milliseconds to emit lightweight socket activity to prevent consumer idle timeout; set 0 to disable (default 1200000 ms).
  • Reconnect On Disconnect — Enable automatic reconnection and resubscription after recoverable socket disconnects (default true).
  • Max Reconnect Attempts — Maximum number of reconnection attempts; 0 for unlimited retries (default 0).
  • Reconnect Failure Window (MS) — Time window in milliseconds for counting reconnect failures in circuit breaker logic (default 300000 ms).
  • Max Reconnect Failures in Window — Maximum allowed reconnect failures within the failure window before opening the circuit breaker; 0 disables this check (default 0).
  • Reconnect Initial Delay (MS) — Initial delay in milliseconds before attempting reconnect with jitter and exponential backoff (default 1000 ms).
  • Reconnect Max Delay (MS) — Maximum delay in milliseconds between reconnect attempts before jitter (default 30000 ms).
  • Max Inflight Events — Maximum number of concurrent custom socket events processed; values >1 may cause out-of-order emission if event handling latency varies (default 8).
  • Max Queue Size — Maximum number of custom socket events to queue while processing is busy (default 128).
  • Overflow Policy — Policy when event queue is full: 'Fail' to error, or drop oldest or newest events (default 'Fail').
  • Require Payload Signature — Require inbound PayloadFrames to include a valid HMAC signature for authenticity (default false).
  • Require Payload Signature For — Which event sources require a payload signature when signature enforcement is enabled (default 'All Event Sources').
  • Deduplicate Events — For custom events, whether to ignore duplicate events with the same eventId within a TTL window (default false).
  • Deduplication TTL (MS) — Time in milliseconds to remember emitted custom event IDs for deduplication; 0 disables deduplication (default 300000 ms).
  • Manual Listen Timeout (MS) — In manual mode, socket closes after this time in milliseconds; 0 to keep listening until stopped (default 15000 ms).
  • Binary Property Prefix — Prefix for any binary properties created from inline event attachments when consuming custom events (default 'attachment').
  • Include Plug Metadata — Whether to include a __plug object with socket and event metadata in each output item (default true).

Output shape

each received event emits one item to the workflow containing event payload and optional metadata

Emitted items represent either agent profile update events or custom events matching subscribed event names. Deduplication and concurrency parameters affect emission behavior. Events do not support wildcard subscription and require exact event names for custom events.

Links

Discussion