Automatically translate this page?
7 December, 2017

Drive telematics diagnostics beyond ordinary with flespi toolbox [UPD: Feb 03, 2020]

flespi toolbox offers comprehensive channel, device, stream, and modem logs, messages history, and more to refine operation of your flespi-based infrastructure.

flespi toolbox is an all-round diagnostic environment for handy debugging and analysis of any activity within the flespi platform. This guide provides practical knowledge that you can start applying to the telematics side of your business straight away.

flespi toolbox login

To get access to a wealth of information about every item in your infrastructure — channels, devices, streams, modems, containers, CDNs, MQTT connections do the following:

(i) Pick the Toolbox inside Telematics hub, Storage or MQTT menu:

flespi toolbox login options

or (ii) navigate to the Toolbox tab on the item's card:

open toolbox tab

or (iii) open Toolbox separately at the link

Note that when opened as a standalone application, Toolbox offers convenient filtering within one element type (e.g. channels). You can filter channels, devices, and streams by name or id, and additionally can filter devices by ident (IMEI) as well.

Main screen

The screen below shows the Channel logs and messages; it will look the same for Devices and Modems (logs on top and messages at the bottom). The Streams only have the logs pane since they only forward messages but do not store them.

flespi toolbox main window

The channel (or another item) selector is right under the logo. To the right of it sits the button switching between historical and real-time logs. Note, that real-time mode also shows a few recent historical messages above the red line.

Now let’s see when flespi toolbox comes in handy, what specific functionality stands behind it, and how your journey through thousands of records can still be effective.

Logs tell stories

Pretty much every action with the item (channel, device, etc.) is logged. This means that you can view at which step the problem occurred, type of problem, when it took place, and more.

For example, you can check the specific error codes within a certain period. Or, if someone made an unauthorized change to your channel settings, you can see when it happened and which specific parameters were affected.

If you want to quickly add columns for specific parameters, click on any record in the Messages pane and in the detailed message view on the right click the "show this column" icon for the parameters you want to monitor:

flespi toolbox show hide columns

To hide the column, click on the icon again.

For more columns customization, click the "config" icon on the top right of the Messages pane (next to the search bar):

flespi toolbox customize columns

Here you can show/hide columns, remove them, change their order, and add custom parameter columns.

Messages carry value

Messages are the core of telematics communication — they are the raw material for any decisions and insights. You don’t need to make a REST API request to view messages, Toolbox presents detailed message information in the chronological order and allows easy flicking through hundreds of lines (just click an arrow button ->). Message viewer is particularly helpful for debugging but you can come up with countless uses depending on your tasks and issues.

For instance, you set up a tracker to send messages every 20 seconds, but suspect that fewer are coming. You can filter messages by ident of the target tracker and look through the timestamps to see if messages arrive as frequently as expected.

If you want to see all message parameters, click anywhere on the message line. You can also add custom columns to the messages table (see how we did it for the logs above).

flespi toolbox messages settings

The copy button in the action column allows copying the entire message content in JSON format and pasting it either to a text editor, an email to a hardware manufacturer or wherever else you may need.

Filters simplify search

Both logs and messages panes feature an identical filter control for quicker navigation through the records. Hover over the column title to see the parameter name to use in the filter.

Here are the supported filtering expressions:

  • logical comparisons (>,>=,<,<=,=) with numeric values — e.g. “duration>20”:
    flespi toolbox filter numeric condition
  • finds a given substring in a string parameter value — e.g. “ident=*est*”:
    flespi toolbox filter string condition
    Wildcard (*) at the beginning of the substring instructs to look for inclusion anywhere in the parameter value (not only from the first position). The "*" at the end tells the filter to perform text value search (not numeric one).
  • several comma-separated conditions — commas are interpreted as an AND statement (all conditions should be met), e.g. “ident=*pass*,duration>40”:
    flespi toolbox filter complex condition

Colors focus attention

The color scheme used for the log records intends to drag your attention to events in order of importance: red ones require immediate attention (errors, failures); yellow ones usually refer to updates, changes, sending messages; green ones report successes, and grey ones signify correct termination or closing.

flespi toolbox logs color scheme

Toolbox also color-codes device messages depending on their "freshness" — the further the message arrival time from the current time, the darker it will show in the list:

message color depending on age

Settings customize experience

The ways you will use toolbox are plenty and diverse that is why we tried to make it flexible.

Gear button on the top right opens global settings which allow specifying the number of lines shown in each of the two tables on the main screen (1000 by default; reduce on slow browsers).

Use the Logs-Both-Messages switch on top to customize which panes to show.

flespi toolbox settings and ratio


We are trying to transform the routine log crawling job into a productive pastime. Tell us what features can improve your experience, and we’ll gladly consider them.

And surely try the joint power of the flespi panel and the flespi Toolbox.

P.S. To stay in sync with the latest changes, subscribe to Toolbox changelog on our forum.