Add an InfluxDB Application

Use InfluxDB to egress data from
FactoryTalk Edge Gateway
.
FactoryTalk Edge Gateway
supports InfluxDB 2.x Open Source and InfluxDB Cloud versions. Set the InfluxDB configuration settings.
To add an InfluxDB Application
  1. In the top-right corner, select
    Online
    to go online with the gateway.
    FactoryTalk Edge Gateway
    displays a green banner:
    Gateway Connection: Online
    .
  2. Select
    Data Flow
    >
    Applications
    .
    • To add the first application, select
      Add Application
      .
    • To add a subsequent application, select
      Add
      .
  3. From
    Select Application
    , select
    InfluxDB
    .
  4. Select
    Next
    .
  5. Set these parameters:
    • Application Name:
      Defines the application name.
    • URL address:
      Enter URL address.
    • Port:
      Select the applicable port. The default port for InfluxDB 2.x Open Source on-premise version is
      8086
      . The default port for HTTPS connection in InfluxDB Cloud version is
      443
      .
    • Organization Name:
      Enter the organization name created in the InfluxDB.
    • Bucket Name:
      Enter the Bucket Name created in the InfluxDB.
    • Token:
      Enter the Token created in the InfluxDB.
    • Max buffer size in bytes:
      Select the Max buffer size from drop-down list.
    • Max time-out in milliseconds:
      Select the Max time-out from drop-down list.
    • Store and forward:
      Stores the data entering the application in a database on the gateway. This setting also functions as a buffer for data entering the store database at higher speeds than it is forwarding to the application. A maximum of 256 KB of data is fetched from the store database at each configured fetch interval. Select
      Store and Forward
      to enable the
      Maximum store size (bytes)
      and
      Fetch Interval (ms)
      settings. In case connectivity is lost to the external application, having
      Store and Forward
      enabled avoids periods of lost data to InfluxDB. Store and Forward keeps data stored in the database until the connection is restored.
    • Maximum store size (bytes):
      This setting defines the maximum size of the store database on the gateway, in bytes. When the maximum store size is reached, the oldest data is deleted to make space for new application data. Select
      Store and Forward
      to enable this setting.
    • Maximum fetch size (bytes):
      This setting defines the maximum size of data to fetch from the store database at each configured fetch interval. Select
      Store and Forward
      to enable this setting.
    • Fetch Interval (ms):
      This setting defines the interval of time to egress (that is, forward) data from the store database, in milliseconds. Data continues to be egressed to the InfluxDB application until the store database is empty. When egress fails, the data remains in the store database. Select
      Store and Forward
      to enable this setting.
    • Aggressive Database Cleaning:
      Select to delete 50% of the oldest data from the store when maximum store size is exceeded.
  6. Select
    Save
    .
    TIP:
    While sending data to InfluxDB,
    FactoryTalk Edge Gateway
    creates two separate fields i.e. “tagName_v” for value and “tagName_q” for quality. But when some of the FTEG tags have a “null” value, it has "bad" quality too and it is unsupported by InfluxDB application. So,
    FactoryTalk Edge Gateway
    creates an additional InfluxDB field “tagname_v_q#” with value set to ‘null’ (as a string) to send “null” value to InfluxDB application. "#" denotes bad quality code in additional field.
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.
Normal