Data forwarding

All data the Teleport devices read out from your assets can be forwarded to a destination in your own cloud. We support destinations like databases (eg. MySQL, MSSQL and Postgres), message brokers (eg. Kafka, RabbitMQ and Redis) and HTTPS endpoints.

TIP

Contact us at support@withthegrid.com to configure data forwarding for your Teleport devices, also in case you want to integrate with a destination that is not yet listed.

Forwarding process

As soon as data from Teleport devices are received by our cloud, our forwarders will deliver it to your destination service. If that fails, for example because your destination service is temporarily offline, the forwarder will retry it 6 times:

AttemptDelay
0None
110 seconds
25 minutes
330 minutes
42 hours
51 day
63 days

If delivery has not succeeded after 6 retries, we'll store the data for you for a while and contact you to discuss delivery options. Note that messages can be delivered out of order when they are retried.

TIP

Our forwarders have IP address 3.72.188.96. We recommend that you whitelist that IP address and block others.

At least once delivery

Messages are guaranteed to be delivered at least once, so duplicates can occur. In database systems this is overcome with unique indexes, that avoid duplicates being inserted. For HTTP and AMQP, you should deduplicate yourself. For messages from devices the combination of teleportHashId, assetIdentifier and measuredAt should be unique.

Reporting interval

Teleports are configured to a default reporting interval of 300 seconds.

TIP

Flash messages have a different default reporting interval (1 second).

Sign convention

Teleport uses the IEC 61850-7-520 Producer Reference Frame (generator sign convention). When an asset:

  • injects active power (generation/battery discharge) the sign of active power is positive.
  • absorbs active power (usage/battery charge) the sign of active power is negative.
  • injects reactive power, the sign of reactive power is positive.
  • absorbs reactive power, the sign of reactive power is negative.

When:

  • active power control is set to a positive value, it is directing the asset to inject active power.
  • active power control is set to a negative value, it is directing the asset to absorb active power.
  • reactive power control is set to a positive value, it is directing the asset to inject reactive power (with the intention to increase voltage).
  • reactive power control is set to a negative value, it is directing the asset to absorb reactive power (with the intention to reduce voltage).