This is documentation for EA software. It may contain information that is out of date and subject to change. Last updated: 3 October 2018.

Configure the Gateway Technical Reference

Overview

Publishing to Gateway Hub is enabled in the Gateway Hub section in the GSE.

This technical reference shows the configuration of the Gateway Hub and Schema configuration in the Publishing tab of a sampler in the GSE.

For more general help regarding installation and set up of Gateway Hub, see Gateway Hub Installation Guide.

For information on schema definitions, see Publish to Gateway Hub User Guide.

Note: Gateway Hub publishing is not available from shared Gateways. Instead, you must enable publishing from the source Gateways.

Gateway Hub section in GSE

Note: Strategies are not used in Gateway Hub.

Configuration

Below are the fields and options available in the Gateway Hub section of the GSE.

Gateway Hub > enabled

This setting allows publishing to Gateway Hub to be enabled/disabled.

Mandatory: No
Default: True

Note: Gateway Hub and Publishing can be enabled at the same time. Errors generated by attempting to publish to Gateway Hub do not affect the operation of Publishing. Similarly, errors generated by attempting to publish using Publishing do not affect the operation of Gateway Hub.

Gateway Hub > publishingAddress

This specifies a comma-separated list of host/port pairs to use for establishing the connection to Gateway Hub. The adapter makes use of all servers irrespective of which servers are specified here for bootstrapping - this list only impacts the initial hosts used to discover the full set of brokers. Please refer to the description of bootstrap.servers in the Kafka documentation for more information.

Note: The technology used to publish from Gateway to Gateway Hub is internal and may change in the future.

Mandatory: No
Default: localhost:9092

Gateway Hub > additionalSettings

These additional settings control how the adapter is loaded, or are settings interpreted by the adapter itself.

Each setting is entered on one line, and each line specifies one key-value pair. Each setting (key) starts with:

  • adapter. - control the way the adapter is loaded.

Settings with the prefix adapter. are:

  • adapter.library.path - specifies the location of the shared library that implements the adapter. The default location is the lib64 sub-directory of the Gateway's working directory. An alternate location can be specified as a path relative to the Gateways's working directory, or as an absolute path (as in the example above).
  • adapter.gateway.name - used with the topic prefix to construct a unique consumer group id for the gateway. The default group id is <topicprefix><gatewayname>, e.g. geneos-DevGateway. If necessary, you can override the gateway name part with this setting.
Mandatory: No

Gateway Hub > secureSettings

This section allows settings that cannot be set in cleartext, such as passwords, to be encrypted in the Gateway setup file.

Gateway Hub > secureSettings > setting > name

The name of the secure setting.

Mandatory: Yes

Gateway Hub > secureSettings > setting > value

The value of the secure setting.

This can either be:

  • stdAES — AES 256-bit encryption. The password is entered in the Set password box.
  • var— a reference to a variable that provides a password in Operating Environment. References to invalid variables, or variables that are not AES-encrypted, are treated as errors.

Gateway Hub > restAddresses

Specifies the https address that is the base URL for the REST endpoints used by Active Console 2.

Mandatory: Yes

Sampler Publishing tab

Publishing tab configuration

User-defined schemas are visible in the Publishing tab of a sampler.

samplers > sampler > schemas > dataviews > dataviewSchema > dataview

Specifies the name of the dataview that the schema applies to. If omitted, the schema applies to the dataview that has the same name as the sampler (the default dataview).

samplers > sampler > schemas > dataviews > dataviewSchema > schema

This has two options:

  • data
  • sampler-schema

Selecting data allows the schema to be specified in the Publishing tab of the sampler.

Selecting sampler-schema allows you to select from a list of schemas saved in Sampler-schemas section of Static variables.

Schema configuration

This screen is accessed through Data... in the Schema > Dataviews section in the Publishing tab of a sampler.

Here you indicate:

  • The columns or headlines in the published dataview,
  • The data types of the columns and headlines.
  • The units of measure for the columns and headlines (if applicable).

samplers > sampler > sampler-schema > headlines > headline > name

Specifies the name of the headline that appears in the dataview.

samplers > sampler > sampler-schema > headlines > headline > type

Specifies the data type of the headline that appears in the dataview.

The data types include: string; boolean; float32; float64; int32; int64; date; dateTime. 32-bit types should be specified unless the data is of a size or precision that requires 64-bit types.

samplers > sampler > sampler-schema > headlines > headline > unitOfMeasure

Specifies the units of measure of the data type that appears in the dataview.

Only certain data types have specified units of measure.

The options for units of measure are outlined in Units of measure used in schemas.

samplers > sampler > sampler-schema> columns > column > name

Specifies the name of the column that appears in the dataview.

samplers > sampler > sampler-schema > data > columns > column > type

Specifies the data type of the column that appears in the dataview.

The data types include: string; boolean; float32; float64; int32; int64; date; dateTime. 32-bit types should be specified unless the data is of a size or precision that requires 64-bit types.

Note: Columns declared as dateTime not in the form yyyy-mm-ddThh:mm:ss require an entry in Standardised Formatting.

samplers > sampler > sampler-schema > columns > column > type > unitOfMeasure

Specifies the units of measure of the data type that appears in the dataview.

Only certain data types have specified units of measure.

The options for units of measure are outlined in Units of measure used in schemas.

samplers > sampler > sampler-schema > pivot

This option should only be used for dataviews that display one value per row with values of a variety of types. For example, a Toolkit sampler with a summary dataview containing two columns - Name and Value, and three rows of varying data types - dateTime, int32, and float32, would be a good candidate for pivoting.

If enabled, the dataview is pivoted so row names become column headings and the heading of the single data column becomes the name of a single data row.

Mandatory: No
Default: False

samplers > sampler > sampler-schema > publish

Turns publishing of the dataview on or off.

Mandatory: No
Default: True

Appendix

Units of measure used in schemas

Name Symbol
percent %
seconds s
milliseconds ms
microseconds μs
nanoseconds ns
days d
per second s-1
megahertz MHz
bytes B
kibibytes KiB
mebibytes MiB
gibibytes GiB
bytes per second B/s
megabits Mbit
megabits per second Mbit/s

Sampler schema types

Below is a list of samplers and if they have an entirely built-in schema, a partially built-in schema, or are entirely user-defined.

Plugin Type Comments
Gateway-breachPredictor Built-in  
Gateway-clientConnectionData Built-in  
Gateway-databaseLogging Built-in  
Gateway-exportedData Built-in  
Gateway-gatewayData Built-in  
Gateway-gatewayLoad Built-in  
Gateway-importedData Built-in  
Gateway-includesData Built-in  
Gateway-licenceUsage Built-in  
Gateway-severityCount Built-in  
Gateway-includesData Built-in  
Gateway-licenceUsage Built-in  
Gateway-managedEntitiesData Partial  
Gateway-probeData Built-in  
Gateway-scheduledCommandData Built-in  
Gateway-scheduledCommandsHistoryData Built-in  
Gateway-severityCount Built-in  
Gateway-severityData Built-in  
Gateway-snoozeData Built-in  
Gateway-sql User-defined  
Gateway-userAssignmentData Built-in  
api User-defined  
api-streams Built-in  
bloomberg-bpipe Built-in  
citrix-apps Built-in  
citrix-processes Built-in  
citrix-sessions Built-in  
citrix-summary Built-in  
clearvision-status Built-in  
combo User-defined  
component-versions Built-in  
cpu Built-in  
desktop-pc-monitoring Built-in  
deviceio Built-in  
disk Built-in  
e4jms-bridges Built-in  
e4jms-connections Built-in  
e4jms-durables Built-in  
e4jms-non-durables Built-in  
e4jms-queues Built-in  
e4jms-routes Built-in  
e4jms-server Built-in  
e4jms-topics Built-in  
e4jms-usersummary Built-in  
euem Built-in  
extractor User-defined  
fidessa Built-in  
fidessa-dq User-defined  
fix Built-in  
fix-analyser2 Partial

Admin data view schema provided, user must define schema for all other dataviews.

fkm Partial  
flm Partial

User must define schema for additional data displayed based on configuration .

ftm Built-in  
gl-greffon Built-in  
gl-lostorders User-defined  
gl-orderbook User-defined  
gl-permissions Built-in  
gl-router Built-in  
gl-slc Partial

User must define schema for additional data displayed based on configuration or SLC log file.

gl-slc-relay Built-in  
gl-sle Built-in  
gl-sle-tcp Built-in  
hardware Built-in  
ibmi-job Built-in  
ibmi-message Built-in  
ibmi-pool Built-in  
ibmi-queue Built-in  
ibmi-subsystem Built-in  
ibmi-system Built-in  
informix Built-in  
ipc Built-in  
ix-ma User-defined  
jmx-server User-defined  
jmx-threadinfo Built-in  
market-data-monitor User-defined  
message-tracker Built-in  
mibmon User-defined  
miss-x Built-in  
mq-channel Built-in  
mq-qinfo Built-in  
mq-queue Built-in  
net-ping Built-in  
network Built-in  
nyxt-papastats Built-in  
oracle Built-in  
orc Built-in  
pats-status Built-in  
pats-trading-breaches Built-in  
pats-users Built-in  
perfmon User-defined  
processes Built-in  
rmc-interface User-defined  
sets-slc Built-in  
sql-toolkit User-defined  
stateTracker User-defined

User must define schema for user defined custom column names.

su Built-in  
sybase Built-in  
sybase-server Built-in  
tcp-links Built-in  
tib-rv Built-in  
tib-rvpublisher Built-in  
tib-rvstream Built-in  
toolkit User-defined  
top Built-in  
trading-technologies Built-in  
trapmon Partial

User must define schema for user-defined columns in custom view.

unix-users Built-in  
veritas-cluster-server Built-in  
web-mon Built-in  
win-cluster Built-in  
win-services Built-in  
winapps Built-in  
wmi User-defined  
wts-licenses Built-in  
wts-processes Built-in  
wts-sessions Built-in  
wts-summary Built-in  
x-broadcast Built-in  
x-mcast Built-in  
x-multicast Built-in  
x-ping Built-in  
x-route Built-in  
x-services Built-in  
x-top Built-in  
x-traffic Built-in