RabbitMQ Integration

GpsGate is now integrated with RabbitMQ. This allows you to forward devices' track data to a RabbitMQ installation and consume it as you wish.


Setup
  1. Login to SiteAdmin and navigate to Plugins.
  2. Change the repository to beta.gpsgate.com and install RabbitMQ. You might have to update Updates.v5 as part of the install.
  3. In SiteAdmin, navigate to Integrations, select RabbitMQ, and click on Add. You should see the following form:
  4. RabbitMQ Configuration
  5. Fill all the fields and save the configuration. During that step you can click on Test in order to test if your configuration is correct.
  6. Once saved and tested, navigate to SiteAdmin -> Applications -> Search and Manage.
  7. Click on the application in which you want to enable the newly created RabbitMQ configuration.
  8. Click on Privileges and features, find and enable RabbitMQ, as well as the configuration you’ve created.
  9. RabbitMQ Privilege
  10. Click on Save.
  11. Login to the Vehicle Tracker application you’ve enabled RabbitMQ in.
  12. Click on Admin -> Roles. The Roles window will open.
  13. Click on Create copy of a already existent Role and give it a new name, such as RabbitMQ.
  14. Select all the users for which you want to enable the Track data to be forwarded to your RabbitMQ installation.
  15. Click on Save.
Date Type

Currently we only support the Tracks Data Type. This will forward the Tracks to RabbitMQ.

Serializer Type

We support two serialization types: Json and Protobuf. Protobuf is recommended since its data is much smaller which will make the data forward faster.

Json definition:


Protobuf definition:

Independently of the serialization, Utc is the track timestamp in milliseconds since Unix Epoch and Speed is in m/s.
Technical details
The RabbitMQ is set up to go through a RabbitMQ Exchange of type topic. Read more here: RabbitMQ topic exchange. This allows you to create multiple queues which will be routed using the Exchange Key.
Routing Key
The Routing Key is templatable, meaning you can use several user specific data to compose the Routing Key. Currently we support three templates:
  1. username - the username of the user
  2. name - the name of the user
  3. imei - the IMEI of the reporting device
Here are a few examples of how to use it:
  • Tracks.[imei]
  • User.[username]
  • [imei]

  •   Discuss this blog post on the forum please



    Download free GpsGate Server

    Install it on your own server. The installation is free for 5 users.

    Download Now