Skip To Content

Push Text to an External TCP Socket

The Push Text to an External TCP Socket output connector can be used to push event data, adapted and formatted as delimited text, to an endpoint address using a TCP socket connection. The delimiter between attribute values is often a comma, so the type of data adapted by this output connector is sometimes referred to as comma separated values text. ArcGIS GeoEvent Server can use any normal ASCII character as a delimiter to separate data attribute values.

Usage notes

Keep the following in mind when using the Push Text to an External TCP Socket output connector:

  • This output connector pairs the Text outbound adapter with the TCP outbound transport.
  • The connector is frequently used to push simulated event data records to GeoEvent Logger.
  • By default, the connector opens a TCP socket on port 5575; however, any available server port can be used.
  • Multiple Push Text to an External TCP Socket outputs can be configured sharing the same port. However, it is recommended that different feeds of event data use their own output connectors and ports.
  • The Message Separator parameter is required. This single character specifies the end of an event record. A newline (\n) is a common end-of-record delimiter.
  • The Attribute Separator parameter is required. This single character separates one attribute value from another. A comma (,) is a common attribute delimiter.

Parameters

The following are the parameters for the Push Text to an External TCP Socket output connector:

ParameterDescription

Name

A descriptive name for the output connector used for reference in GeoEvent Manager.

Host (Client Mode)

The host address GeoEvent Server will establish a TCP socket connection to. The default is localhost, but any accessible hostname or IP address can be specified.

Server Port

The server port to use when establishing the TCP socket connection. GeoEvent Server must be able to discover and connect over this port. The default is port 5575, but any available server port can be specified.

Connection Timeout (Client Mode)

Specifies the amount of time, in seconds, GeoEvent Server will attempt to make a TCP socket connection to the remote server as a client. If a TCP socket connection cannot be established in the specified amount of time, the output connector will report an error.

Message Separator

A single literal character that indicates the end of an event data record. Unicode values may be used to specify a character delimiter. The character should not be enclosed in quotes. A newline (\n) is a common end-of-record delimiter.

The default is a newline (/n). The outbound message will contain event data records separated by a newline.

Attribute Separator

A single literal character used to separate one attribute value from another in a message. Unicode values may be used to specify a character delimiter. The character should not be enclosed in quotes. A comma is a common attribute delimiter.

The default is a comma. The outbound message will be comma separated text.

Output Date Format

Specifies the format of date/time values written to the file. The available output date formats are ISO 8601 Format or a Custom Format. The default is ISO 8601 Format.

  • ISO 8601 Format—Processed date/time values will be constructed in adherence the ISO 8601 format (yyyy-MM-dd'T'HH:mm:ss.SSSXXX).
  • Custom Format—Processed date/time values will be constructed in adherence to a custom format using the JavaSimpleDateFormat class convention.

Custom Date Format

(Conditional)

The custom format for date/time values written to the file. The custom date format should be constructed using the JavaSimpleDateFormat class convention. For more information, see the SimpleDateFormat.

The parameter is shown when Output Date Format is set to Custom Format and is hidden when set to ISO 8601 Format.

Language for Number Formatting

The locale identifier (ID) used for locale-sensitive behavior when formatting numbers from data values. The default is the locale of the machine GeoEvent Server is installed on. For more information, see Java Supported Locales.


In this topic
  1. Usage notes
  2. Parameters