Skip to main content
All CollectionsKnowledge Articles (Internal base)TT2/Admin Panel (Internal)
Flespi Troubleshooting
Flespi Troubleshooting
Albert Basiul avatar
Written by Albert Basiul
Updated over 7 months ago

Description

This article will cover procedures on how to troubleshoot a device that uses FLESPI

Necessary information

  • Flespi authentication token

How to get Flespi Authentication Token?

  1. Ask 2nd line to provide it, OR

  2. Open a Jira Task to request the Flespi Token

    • Jira Project: Trust Track 2 (GUI)

    • Issue Type: Consultation

    • Issue Summary: Provide Flespi Token

    • Issue Description:
      ​      Please, provide Flespi Token. It will be used to troubleshoot third-party device communication issues and help to provide information when opening Bugs/Incidents.

Devices that we support through FLESPI

Device Manufacturer

Server IP

Server Port

Compatible Devices

Teltonika

4238.flespi.gw

25786

https://flespi.com/protocols/teltonika#devices

Queclink

3801.flespi.gw

27468

https://flespi.com/protocols/queclink#devices

Meitrack

5070.flespi.gw

36216

https://flespi.com/protocols/meitrack#devices

Concox

169.flespi.gw

26742

https://flespi.com/protocols/concox#devices

Calamp

5071.flespi.gw

33763

https://flespi.com/protocols/calamp#devices

Data workflow

  1. Third-party FM tracker generates record and send to a specifc server and port

  2. A Flespi channel (a server IP/Port) receives the record)

  3. Flespi interpreter this record and parse it according to each manufacturer device protocol

  4. Flespi then saves this record according to its own parameter protocol (key-value)

  5. Flespi sends this new record to a Queue (each channel has its own Queue), saying that a new record is available to be consumed

  6. Our flespi-service which is actively listening to this queue, notices a new message, get that information and parses as Trust Track can understand it.

What is a Channel on Flespi?

A channel is an entry point for messages from tracking devices or other platforms. A channel operates via a single protocol which means that one channel can receive messages from tracking devices of one manufacturer. Channel has a unique dedicated host:port to point your tracking devices to.

Source: https://flespi.com/kb/channel-entry-point-to-gateway

What to check if no data is received from the third-party device on TT2?

  1. Check if the respective channel is active on the Flespi application

    1. If not, please raise an Incident

    2. If it is, move to the next step

  2. Check if the respective queue is active on the Flespi application

    1. if not, please raise an Incident

    2. If it is, move to the next step

  3. Check if we are receiving data from devices in general in that channel.

    1. if not, please raise an Incident

    2. If it is, move to the next step

  4. Check if we are receiving data for that specific device that the client is complaining

    1. if not, proceed with the Third-party basic troubleshooting (pending creation)

    2. If it is, move to the next step

How to login on Flespi platform

  1. Login to https://flespi.io/

  2. Click on the LOGIN / REGISTER button

  3. A popup will open, click on the hightlighted option
    ​

    mceclip0.png

  4. Click on LOGIN BY TOKEN
    ​

    mceclip1.png

  5. Paste the TOKEN and click on the LOGIN button
    ​

    mceclip2.png

  6. You will be asked to save the token or not, its up to you, this token will remain saved for 31 days
    ​

    mceclip3.png

  7. After that, you're now logged in and will be redirected to the main dashboard
    ​

    mceclip4.png

How to check if a Channel is active?

  1. Assuming that you are logged in

  2. Click on Telematics Hub on the left menu
    ​

    mceclip0.png

  3. Click on Channel (DO NOT CLICK ON THE + SIGN)
    ​

    mceclip1.png

  4. Check if the highlighted button is GREEN, if not, contact OnDuty
    ​

    mceclip0.png

  5. Check the traffic chart is updating every 10 seconds, if not this can be an indicator that records are not arriving.

    mceclip1.png

How to check if a Session (Queue) is active?

  1. Assuming that you are logged in

  2. Click on MQTT on the left menu
    ​

    mceclip2.png

  3. Click in Sessions (DO NOT CLICK ON THE + SIGN)
    ​

    mceclip4.png

  4. The respective session should be GREEN (DO NOT CLICK ON THE RED CIRCLE)
    ​

    mceclip5.png


    Note: There can be multiple sessions for a given channel. For example, teltonika has 1 channel and 2 sessions. one called teltonika-1 and the other teltonika-2, be sure to check all sessions related to the respective channel you are troubleshooting

How to check if we are consuming (acquiring) messages from each Flespi Session (Queue)?

  1. Assuming that you are logged in and on the main screen

  2. Click on MQTT on the left menu
    ​

    mceclip3.png

  3. Click in Sessions (DO NOT CLICK ON THE + SIGN)
    ​

    mceclip3.png

  4. Look for the respective Session(queue) you would like to check, in this example, I looked for Teltonika's.

  5. Look for the highlighted icon, as shown in the image below, it should not appear or it should have a number low number, also check the storage value, it should be zero or close to zero

mceclip2.png

This icon represents the number of PUBACK (publish acknowledgment) messages waiting in queue to be consumed by the client (Ruptela).

Our server consumes new messages periodically, that is why this icon should not be shown or its number should be low If we have a different situation (the number is high or the storage amount is high), then our clients might experience a "Data Delay" on Trust Track because we are not acquiring the new records that their devices are sending to Flespi.

How to check if we are receiving data from devices in general on a given channel?

  1. Assuming that you are logged in

  2. Click on Telematics Hub on the left menu
    ​

    mceclip0.png

  3. Click on Channel (DO NOT CLICK ON THE + SIGN)
    ​

    mceclip1.png

  4. Now click on the channel that you want to check (in this case I am clicking on Teltonika)

  5. Click in LOGS & MESSAGES and wait (this can take 30s~1m to load)
    ​

    mceclip6.png

  6. Check if new messages are arriving and the timestamp

    mceclip7.png

How to check if we are receiving data from a specific device?

  1. Assuming that you are logged in

  2. There are two ways

    1. Following the procedure "How to check if we are receiving data from devices in general on a given channel?"

    2. Going directly to the Toolbox application

      1. Click on Toolbox on the left menu
        ​

        mceclip8.png

      2. Click in Channels
        ​

        mceclip9.png

      3. Select the respective channel you want
        ​

        mceclip10.png

  3. Now that you entered the Toolbox application using either two options listed above. Click in the Message textbox
    ​

    mceclip11.png

  4. Type this: ident="insertIMEIhere"

    1. Using this IMEI as an example: 357544371058138

    2. The command would be this: ident="357544371058138"

    3. Hit ENTER

  5. All records for this given IMEI will be displayed in ascending order by timestamp for the given timestamp on the right side of the textbox

    mceclip12.png

More info on the toolbox can be found here: https://flespi.com/tools/toolbox

Related Articles
How to correct mileage
How to add Hardware template for service provider/client
How to add new hardware and template to the Hardware list of a Service Provider LCM
Reading data via Transparent channel - basic troubleshooting and general information
Basic Teltonika devices configuration
Did this answer your question?