Skip To Content

GeoEvent Simulator

What is GeoEvent Simulator?

GeoEvent Simulator is a Windows application available with ArcGIS GeoEvent Server that can be used to send event data from a simulation text file or feature layer to a specified TCP socket. Event data sent from GeoEvent Simulator are received by a Receive Text from a TCP Socket input in GeoEvent Server which hosts and monitors the TCP socket to which simulated data is being sent. The input's TCP Transport receives the data as a byte stream; the input's Text Adapter uses a GeoEvent Definition to interpret the data to create a GeoEvent. If the input is incorporated in a GeoEvent Service, the GeoEvent is placed on a message queue for the GeoEvent Service to retrieve and process.

Access GeoEvent Simulator from the Windows ArcGIS program group. Below are some of the key components of the GeoEvent Simulator:

GeoEvent Simulator components

Property or Field NameDescription

1 - Server

The hostname of the server to which GeoEvent Simulator should try to connect. The default is localhost.

2 - TCP Socket

The TCP socket on the specified server to which GeoEvent Simulator should send its simulated event data.

3 - File / Layer Selector

Specify whether the simulated event data will be loaded from a text file or a feature layer. Simulating data from a CSV file is the most typical use case for GeoEvent Simulator.

4 - File / Layer Resource

Text field specifying the path name to the file or the URL to the feature layer from which GeoEvent Simulator will retrieve event data.

5 - Message Rate

The rate at which event data will be sent. The default is to send one event record every 1000 milliseconds. Change this value to send data at a faster rate (for example: 5 messages every 250 milliseconds) or a slower rate (for example: 1 message every 2500 milliseconds).

6 - Go to Start, Play, Step, and Continuous Loop

Use the Go to Start, Play, and Step controls to set GeoEvent Simulator to the beginning of the event data, to start sending all events, or to send a single event record to GeoEvent Server.

Continuous Loop specifies whether GeoEvent Simulator should continuously loop back (or replay) the event data once the last record is reached.

7 - Next Event / Messages

Displays a delimited text representation of the next event record to be sent to GeoEvent Server.

8 - Event Index

Provides the ability to scroll through the simulated event data. As the position changes, the current index displayed in the middle of the range changes to indicate the current event index.

9 - Time Field #

Choose the field in the simulated event data which specifies the date/time. The array is zero-based, meaning the epoch long integer (in the example illustrated above) is the value immediately to the right of the event record's unique identifier (or TRACK_ID).

10 - Set Current Time

When checked, GeoEvent Simulator will discard the date/time information retrieved from the simulated event data and replace it with the system's current time.

11 - Time Value Displays

The text field on the left displays the date/time of the event record retrieved from the simulated event data. The text field on the right displays the date/time that will be sent with the simulated event record.

12 - Last Event / Message

Displays a delimited text representation of the event record most recently sent to GeoEvent Server.

Connecting GeoEvent Simulator to GeoEvent Server

Upon opening GeoEvent Simulator for the first time, you will need to connect to a TCP socket hosted by one of your GeoEvent Server inputs before you will be able to send simulated event records to GeoEvent Server. Use GeoEvent Manager to configure a Receive Text from a TCP Socket input and set a specific socket GeoEvent Simulator can connect.

With a TCP/Text input configured and started in GeoEvent Server, refer to the steps below to connect GeoEvent Server to GeoEvent Simulator:

  1. Set the Server and Port values to match those specified in the TCP/Text input (the defaults are localhost and port 5565).
  2. Click Connect to server to establish the connection between GeoEvent Simulator and GeoEvent Server on the specified server and TCP port. A valid connection has been established when the icon changes to connection established.

Loading event data into GeoEvent Simulator

To load simulated event data into GeoEvent Simulator you must either browse to a CSV or TXT file whose content represents event data as delimited text or choose to load event data from features in a feature layer.

Load event data from a CSV or TXT file

To load event data from a CSV or TXT file follow the steps below.

  1. Set the File/Layer drop-down to File.
  2. Click browse to file to browse to a CSV or TXT file and set the following properties as appropriate for your event data.
    • Enter a Event Separator and Field Separator if appropriate.
    • If the event data has an attribute field with event date/time, choose the Time Field #.
    • If the event data includes field names (i.e. headers) for each column, choose how many lines to skip from the top so not to include the field names (i.e. headers).
    • Review the event data in the preview window.
    • Click Load to load the event data into GeoEvent Simulator.

    The event data contained in a CSV or TXT file must have both a clear delimiter between each attribute value and a clear delimiter between each event record. The default delimiters are a comma (,) between attributes and a new-line between event records.

    The Load From File dialog displays the first dozen or more event records, parsed using your specified delimiters. It is important that attribute values (e.g. Field 0, Field 1, Field 2, Field 3, etc.) map to attribute fields specified in a GeoEvent Definition and that the values in a CSV or TXT file can be implicitly cast to the data types specified for each attribute in a GeoEvent Definition.

    Date/time values can be represented as a string in the ISO 8601 format (e.g. 2016-12-31T23:59:59+00:00) or an epoch long integer expressed in milliseconds (e.g. 1483228799000). The ISO 8601 and epoch long integer formats tend to be less ambiguous, but an input connector will try to interpret string values sent from GeoEvent Simulator such as 12/31/2016 23:59:59 or 12/31/2016 12:59:59 PM as a date.

Load event data from a map/feature service

Another option for loading simulated event data into GeoEvent Simulator is to load feature records from a feature service. Follow the steps below to add event data from a feature service.

  1. Set the File/Layer drop-down to Layer.
  2. Click load from layer to open the Load From Layer dialog
  3. Click select layer to open the Select Layer dialog and set the properties appropriate for you environment.
    1. Enter the URL to the server that is hosting the map or feature service you want to read data from.
    2. Enter the credentials for connecting to the specified server.
    3. Click Connect to connect to the specified server.
    4. Upon successful connection, click Browse to Layer.
    5. Choose a service folder, feature service, and layer (the URL constructed from these parameters will be displayed) and click OK.
  4. From the Load From Layer dialog, click connect to.
    1. Enter the URL used to connect to GeoEvent Server.
    2. Click OK to enter the credentials used to connect to GeoEvent Server.
      Nota:

      If GeoEvent Server is federated, you will need to use the administrative credentials for Portal for ArcGIS to login. If GeoEvent Server is not federated, then use the administrator credentials as defined in the underlying ArcGIS Server's user/role provider.

    3. Click Login to establish the connection to the GeoEvent Server.

      Login to GeoEvent Server is enabled by default. For backward compatibility (version 10.8 or earlier) you will need to disable authentication. To disable authentication in GeoEvent Logger, click Options in the menu and uncheck Use GeoEvent Server admin Endpoints. Once again, this is only necessary for backward compatibility when you need to connect GeoEvent Logger at version 10.8.1 or later to a GeoEvent Server that is version 10.8 or earlier.

      GeoEvent Simulator options

    When loading data from a CSV or TXT file, specifying an Event Separator and a Field Separator was necessary so GeoEvent Simulator understood how to interpret the delimited text. When loading event data from a feature layer, you must specify a GeoEvent Definition that GeoEvent Simulator should use to interpret the feature records. Use GeoEvent Manager to import a GeoEvent Definitions from the feature layer by following the high-level steps below.

  5. Choose the appropriate Input GeoEvent Definition from the drop-down list that matches the schema of the feature layer.
  6. Accept the default name for the Output GeoEvent Definition Name.
  7. Click Load to load the feature records from the specified feature service's feature layer.
  8. Review the delimited text representation of the next event record in GeoEvent Simulator's Next Event Message text box. Hover over the text box to view the entire string of the event record as illustrated below.
    GeoEvent Simulator event record example

    Notice GeoEvent Simulator prepended the name of the GeoEvent Definition chosen to its delimited text representation of the event record. This delimited text is what GeoEvent Simulator will send to GeoEvent Server.

  9. Open GeoEvent Manager, set the Receive Text from a TCP Socket inputs Incoming Data Contains GeoEvent Definition property to Yes. The input connector will then expect each event record to include the GeoEvent Definition name.

    Since GeoEvent Simulator is sending a JSON representation of the feature record's geometry, ensure the last value in the delimited string maps to a field of type geometry in the GeoEvent Definition that is used by the input connector receiving the event data.

  10. Optionally, in GeoEvent Simulator, once feature records from a feature service are loaded, you can choose to save the event records to a CSV file by choosing File > Save As from the main menu.