Apps Market - Fuel Tank Manager


In this article, you're going to learn how to analyse the consumption of your fuel tanks using the Fuel Tank Manager App. 

Contents of this article: 




This app allows you to calculate the consumption of your fuel tanks. Manage your Fuel tanks by importing your readings and loads and convert them into consumption. This app is available on the Analysis screen.



  • Have available data in your account. 
  • Have superAdmin or Admin permissions.
  • Install the Fuel Tank Manager app on your account from the Apps market.


How does it work?

Getting started

  1. The first step before start using the application is to create a new virtual gateway where all the new virtual devices created in this application will be associated. 
  2. Then, click on the "Configure Gatewaybutton. Here you should select the gateway created in step 1 and indicate the token you can find when you are editing the gateway. Once you have indicated the token, click on "Save". It should appear a message indicating that the token is correct. 

Creating a tank

In order to create your first Tank, click on "New tank" and fill the following fields:

  • Tank Name: name of the tank
  • Assigned Location: location where the tank is part of
  • Minimum stock: minimum stock allowed 
  • Maximum stock: maximum stock allowed  
  • Initial stock: first measurement done
  • Initial date: date where the initial stock was measured
  • Initial hourhour where the initial stock was measured
  • Description: optional field, to include some additional information

Important: as soon as you click on Save, a new device will be created under the gateway configured in the first step. Accept the device and assign it to its corresponding location.
As all the data is imported using the generic parameter 50311, now it is the best moment to derive the generic parameter to a more useful parameter for you to analyse it afterwards. 


Import readings

You can import readings in 2 ways:

  1. Manually
    • ​​Value: value you would like to import
    • Timestamp: date and hour of the reading you would like to import
    • Type: if it is a reading (you are indicating the level of the tank) or a load (if you have reloaded the tank)
  1. Through Excel file
    • ​Just select the file you would like to upload. The format should be something as follows: 



The reading column should contain the readings at each time period, and the load column should contain the tank volume loaded, not the reading after loading. In the example above, the reading for 31/03/2016 at 21:00 would be 200, the sum of the previous readings plus the amount loaded.

Using the app: Analysis Screen

You can visualise the tank consumption, if you still haven't derived the generic parameter (503), in the screens: By Device, Queries and Advanced Analytics. In case you have derived the generic parameter, you can check in which screens it can be visualised.
Taking as an example the previous image in the Excel file, the app will create a new device with the following consumption: 
- from 23/12/2015 11:00 to 17/02/2016 15:00 --> 50
- from 17/02/2016 15:00 to 22/03/2016 10:00 --> 10
- from 22/03/2016 10:00 to 31/03/2016 15:00 --> 30
from 31/03/2016 15:00 to 22/04/2016 12:00 --> 30 
- from 22/04/2016 12:00 to 18/05/2016 17:00 --> 40 

This consumption will be divided by the number of hours between the corresponding "from" and "to", and imported with an hourly frequency.

Was this article helpful?