Edge 1.2.0

Edge UDP Send Node

The UDP Send Node allows an edge workflow to send a UDP datagram to a given address and port.

UDP Send Node

Configuration

UDP Send Node Configuration

To configure the UDP send node, you must provide a destination and a message:

  • Host Template: (Required) A string template for destination address. This can be either an IPv4 or IPv6 address, or a hostname that resolves to an address. With agent version 1.19.2, you may elect to allow a broadcast address (e.g. 255.255.255.255) with the provided checkbox.
  • Port Template: (Required) A string template for destination port. This must resolve to a valid port (between 1 and 65535).
  • Message Encoding: The encoding for the datagram (defaults to UTF8).
  • Message: A string template for the contents of the UDP datagram to send.

Result

UDP Send Node Node Output

You can optionally store the result of the UDP send on the payload for later use in the workflow. A successful UDP send will have the result { success: true }. A UDP send that results in an error will have a result of the form { error: <error> }.

UDP Caveats

Due to the nature of UDP, just because a UDP send succeeds does not mean the destination received the message - all it means is the message was successfully sent. UDP has no built in guarantees around message delivery. In addition, large UDP messages (greater than 1KB) may be dropped or fragmented by intermediate systems or networks, so if you are planning to send large UDP messages, we recommend running some tests first.