ConHiveConHive Docs
ModulesAutomation Manager

Automation Manager workflow nodes

Workflow builder nodes of the Automation Manager module.

These nodes appear in the workflow builder when the Automation Manager module is available.

If

Evaluates the condition group against the payload with the shared flowexpr evaluator and routes the message to True or False. Stateless.

Inputs

NameDescriptionTypeRequired
ValueMessage to evaluate.group of fieldsYes

Outputs

NameDescriptionType
TrueConditions matched.group of fields (list)
FalseConditions did not match.group of fields (list)

Settings

FieldDescriptionTypeRequiredAllowed valuesDefault
ConditionsCondition group deciding between the True and False output.group of fieldsNo

Switch

Evaluates the rules in order against the payload. In first_match mode the first matching rule decides, in all_matches mode every matching case output fires. No match goes to Default. Stateless.

Inputs

NameDescriptionTypeRequired
ValueMessage to evaluate.group of fieldsYes

Outputs

NameDescriptionType
Case1Rules routed to case1 matched.group of fields (list)
Case2Rules routed to case2 matched.group of fields (list)
Case3Rules routed to case3 matched.group of fields (list)
Case4Rules routed to case4 matched.group of fields (list)
DefaultNo rule matched.group of fields (list)

Settings

FieldDescriptionTypeRequiredAllowed valuesDefault
RulesRules evaluated in order.list of group of fieldsNo
Modefirst_match stops at the first matching rule; all_matches routes to every matching output. No match goes to Default.choiceNofirst_match; all_matchesfirst_match

Join

Waits for a message on both A and B with the same key within window_seconds and emits them joined. Unmatched messages go to Timeout when emit_timeout is set.

Inputs

NameDescriptionTypeRequired
PortAFirst message of the pair; joined with the message on B that has the same key.group of fieldsYes
PortBSecond message of the pair; joined with the message on A that has the same key.group of fieldsYes

Outputs

NameDescriptionType
JoinedBoth inputs arrived within the window.group of fields (list)
TimeoutUnmatched message after the window expired.group of fields (list)

Settings

FieldDescriptionTypeRequiredAllowed valuesDefault
Window secondsSeconds to wait for the partner message with the same key.numberNoat least 130
Key pathsPayload paths forming the correlation key. Empty = global.list of textNo
Emit timeoutEmit an unmatched message on the Timeout output when the window expires.yes/noNo
Max pendingMaximum waiting messages (both sides together); oldest are evicted beyond it.numberNoat least 110000

Log

Writes one line per incoming message to the node log of the deployment and to the log of the device or cloud process, with the configured prefix and the message payload. The message continues on the Passed output when it is connected.

Inputs

NameDescriptionTypeRequired
ValueMessage to log.group of fieldsYes

Outputs

NameDescriptionType
PassedThe unchanged message.group of fields (list)

Settings

FieldDescriptionTypeRequiredAllowed valuesDefault
PrefixText written in front of the message payload in every log line.textNoat most 200 characters
LevelLog level of the line: debug, info, warn or error.textNoat most 8 charactersinfo

Stop

Terminates a branch: the message is consumed and logged with the configured reason.

Inputs

NameDescriptionTypeRequired
ValueMessage to consume.group of fieldsYes

Settings

FieldDescriptionTypeRequiredAllowed valuesDefault
ReasonReason logged when a message ends here.textNo

Counter

Counts messages per key, optionally within a sliding window, and emits on Reached when threshold is hit.

Inputs

NameDescriptionTypeRequired
ValueMessage to count.group of fieldsYes

Outputs

NameDescriptionType
ReachedMessage that reached the threshold.group of fields (list)

Settings

FieldDescriptionTypeRequiredAllowed valuesDefault
ThresholdCount at which the Reached output fires.numberNoat least 13
Window secondsSliding window in seconds. 0 = no window.numberNoat least 0
Key pathsPayload paths forming the key. Empty = one global counter.list of textNo
Reset on reachReset the counter after the threshold is reached.yes/noNo
Max keysMaximum tracked keys; oldest are evicted beyond it.numberNoat least 15000

Cooldown

Passes a message and drops all messages with the same key during cooldown_seconds. With key_paths set it deduplicates; without, it is a global cooldown.

Inputs

NameDescriptionTypeRequired
ValueMessage to gate.group of fieldsYes

Outputs

NameDescriptionType
PassedMessage that started a new cooldown.group of fields (list)
DroppedMessage dropped during cooldown.group of fields (list)

Settings

FieldDescriptionTypeRequiredAllowed valuesDefault
Cooldown secondsSeconds after a passed message during which further messages with the same key are dropped.numberNoat least 160
Key pathsPayload paths forming the key. Empty = one global cooldown. With key_paths the node acts as a deduplicator.list of textNo
Max keysMaximum tracked keys; oldest are evicted beyond it.numberNoat least 11000

Signal Rule

Evaluates conditions on named signals (classification scores or mapped payload values) with hysteresis, minimum duration, gap tolerance, combination (all/any/at least) and inhibit conditions. Emits Fired (and Cleared in state mode) with the contributing signal values; events dropped by cooldown or inhibit go to Suppressed. Keeps a ring buffer for timeline and dry run.

Inputs

NameDescriptionTypeRequired
ValueAny message, including audioanalysis ClassificationResult.group of fieldsYes

Outputs

NameDescriptionType
FiredRule fired.group of fields (list)
ClearedState ended (state mode only).group of fields (list)
SuppressedFire suppressed by cooldown or an inhibit condition.group of fields (list)

Settings

FieldDescriptionTypeRequiredAllowed valuesDefault
ConditionsConditions evaluated on the incoming signals.list of group of fieldsNo
CombineHow the required conditions are combined.choiceNoSIGNAL_COMBINE_ALL (All required conditions must be met (default).); SIGNAL_COMBINE_ANY (At least one required condition must be met.); SIGNAL_COMBINE_AT_LEAST (At least at_least required conditions must be met.)
At leastNumber of required conditions that must be met. Only used with AT_LEAST.numberNoat least 1
Window sMemory time in seconds within which required conditions may be met at different times.numberNoat least 0
Inhibit hold sSeconds an inhibit keeps blocking after it ended. Unset = window_s.numberNoat least 0
ModeOutput behaviour: single events or state with clear.choiceNoSIGNAL_RULE_MODE_EVENT (Emit one Fired event per occurrence (default).); SIGNAL_RULE_MODE_STATE (Emit Fired when the state begins and Cleared when it ends.)
Cooldown sSeconds after a fire during which further fires are suppressed.numberNoat least 0
Clear after sSeconds without a met rule before Cleared is emitted. Only used in STATE mode.numberNoat least 0
Stale after sSeconds without a sample until a level signal counts as no data. 0 = automatic (5 x sample interval, at least 5 s).numberNoat least 0
MappingsMappings for non-classification messages.list of group of fieldsNo
Key pathsPayload paths forming the key (state is kept per key). Empty = global.list of textNo
Max keysMaximum tracked keys; oldest are evicted beyond it.numberNoat least 11000
Buffer minutesRing buffer length in minutes for the timeline and dry run.numberNo1 to 144030

Throttle

Passes up to max_events messages per window_seconds and key; further messages go to the Dropped output. Keys are built from key_paths (empty = global).

Inputs

NameDescriptionTypeRequired
ValueMessage to rate-limit.group of fieldsYes

Outputs

NameDescriptionType
PassedMessage within the rate limit.group of fields (list)
DroppedMessage above the rate limit.group of fields (list)

Settings

FieldDescriptionTypeRequiredAllowed valuesDefault
Max eventsMaximum events passed per window and key.numberNoat least 11
Window secondsWindow length in seconds.numberNoat least 160
Key pathsPayload paths forming the key. Empty = one global counter.list of textNo
Max keysMaximum tracked keys; oldest are evicted beyond it.numberNoat least 11000

Time Now

Emits the agent's current system timestamp as a formatted string on every tick of the configured interval. The format is defined using Go's reference time layout (Mon Jan 2 15:04:05 MST 2006). Use this node whenever you need to inject a periodic timestamp signal into a flow — for example, to timestamp each processing cycle, to provide a time reference for time-based comparisons downstream, or to trigger other nodes at regular intervals with a current-time label attached. The ticker interval is shared with the IntervalTriggerConfig configuration. Example 1: emit an ISO 8601 timestamp every 10 seconds and pass it to a JsonProcessor that assembles a heartbeat payload for an external monitoring system. Example 2: emit the current date string (format '2006-01-02') once per minute as a key for daily database partitioning.

Outputs

NameDescriptionType
TimestampCurrent system time formatted according to the configured Go layout string.text (list)

Debounce

Collapses bursts of messages with the same key: trailing emits the last one after quiet_seconds of silence, leading emits the first one immediately.

Inputs

NameDescriptionTypeRequired
ValueMessage to debounce.group of fieldsYes

Outputs

NameDescriptionType
ValueDebounced message.group of fields (list)

Settings

FieldDescriptionTypeRequiredAllowed valuesDefault
Quiet secondsQuiet period in seconds without new messages (same key) before the debounce fires.numberNoat least 15
Key pathsPayload paths forming the key. Empty = global.list of textNo
Edgetrailing emits the last message after the quiet period; leading emits the first message immediately and suppresses the rest.choiceNoleading; trailingtrailing
Max pendingMaximum keys with a pending debounce; beyond it new keys are dropped.numberNoat least 11000

Wait

Holds a message for delay_seconds and then emits it on Elapsed. A message on Cancel with the same key releases the pending one on Cancelled instead.

Inputs

NameDescriptionTypeRequired
ValueMessage to delay.group of fieldsYes
CancelCancels the pending message with the same key.group of fieldsNo

Outputs

NameDescriptionType
ElapsedDelay elapsed without cancel.group of fields (list)
CancelledPending message cancelled before the delay elapsed.group of fields (list)

Settings

FieldDescriptionTypeRequiredAllowed valuesDefault
Delay secondsDelay in seconds before the message is released.numberNoat least 110
Key pathsPayload paths forming the key used by Cancel and replace mode. Empty = global.list of textNo
Modeper_message delays every message independently; replace keeps only the newest pending message per key.choiceNoper_message; replaceper_message
Max pendingMaximum messages waiting at once; beyond it new messages are dropped.numberNoat least 11000

Time Window

Routes each message to Inside or Outside depending on the current time of day and weekday against start_time/end_time. Stateless.

Inputs

NameDescriptionTypeRequired
ValueMessage to route.group of fieldsYes

Outputs

NameDescriptionType
InsideMessage arrived inside the window.group of fields (list)
OutsideMessage arrived outside the window.group of fields (list)

Settings

FieldDescriptionTypeRequiredAllowed valuesDefault
Start timeWindow start in HH:MM (24h).textNo5 to 5 characters
End timeWindow end in HH:MM (24h). An end before the start wraps over midnight.textNo5 to 5 characters
WeekdaysActive weekdays (mon, tue, wed, thu, fri, sat, sun). Empty = all days. For a window that wraps over midnight, the weekday of the start counts (fri with 22:00-06:00 covers Fri 22:00 to Sat 06:00).list of textNo
TimezoneIANA timezone name, e.g. Europe/Berlin. Empty = device timezone.textNo

Generic Convert

Constructs a typed protobuf message from arbitrary input by walking configured JSONPath mappings and defaults. Supports percent / uuid / now / level / cardinal-direction transforms. Target type is resolved at runtime from the global proto registry, so any message compiled into the agent binary (DroneEvent, ClickEvent, Vektri, …) is a valid target. Missing source paths are skipped silently — only fully invalid configuration errors out.

Inputs

NameDescriptionTypeRequired
AnyValueThe arbitrary value to convert. Can be any registered proto message or a generic JSON-shaped object.group of fieldsYes

Outputs

NameDescriptionType
AnyValueThe constructed proto message of the configured target_type. Downstream nodes type-assert against the expected proto.group of fields (list)

Settings

FieldDescriptionTypeRequiredAllowed valuesDefault
Target typeFully-qualified protobuf message name (without the package), e.g. DroneEvent, ClickEvent, Vektri. Resolved at runtime via protoregistry.GlobalTypes. Anything registered in the binary is a valid target.textYes1 to 200 characters
Target packageOptional protobuf package prefix used when resolving target_type. If empty, the registry is scanned by short name and the lookup fails when more than one message matches across packages. Set this to disambiguate (e.g. dronesensor, clicksensor, ares).textNoat most 200 characters
MappingsField mappings from input to output. Applied in order — later mappings overwrite earlier ones for the same to path.list of group of fieldsNo
DefaultsDefault values applied after all mappings. Use these for fields the source does not provide (timestamps, UUIDs, sensor IDs, confidence-derived levels).list of group of fieldsNo

Set Fields

Applies the configured assignments to the payload and passes the result on. With keep_other_fields off, only the assigned fields remain.

Inputs

NameDescriptionTypeRequired
ValuePayload to modify.group of fieldsYes

Outputs

NameDescriptionType
ValueModified payload.group of fields (list)

Settings

FieldDescriptionTypeRequiredAllowed valuesDefault
AssignmentsAssignments applied in order.list of group of fieldsNo
Keep other fieldsKeep all other fields of the incoming payload.yes/noNotrue