Difference between revisions of "Template:Networking rut manual mobile traffic"

From Teltonika Networks Wiki
Line 18: Line 18:
 
     <td>Enable</td>
 
     <td>Enable</td>
 
         <td>yes | no; Default: <b>no</b></td>
 
         <td>yes | no; Default: <b>no</b></td>
         <td>Enables Mobile Traffic Usage Logging {{#ifeq: {{{name}}} | RUT850 ||(can also be enabled from <b>Services → [[{{{name}}} Modbus|Modbus]]</b>}})</td>
+
         <td>Enables Mobile Traffic Usage Logging {{#ifeq: {{{name}}} | RUT850 ||(can also be enabled from <b>Services → [[{{{name}}} Modbus|Modbus]]</b>)}}</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>

Revision as of 13:14, 5 December 2018

Summary

The Mobile Traffic section contains graphs that display mobile data usage values over different periods of time.

Configuration

Mobile Traffic Usage Logging is inactive by default and must first be enabled in the Configuration section in order to start logging data usage values:

[[File:{{{configuration_file}}}]]

field name value description
Enable yes | no; Default: no Enables Mobile Traffic Usage Logging (can also be enabled from Services → [[{{{name}}} Modbus|Modbus]])
Interval between records (sec) integer [3..∞]; Default: 10 Specifies the frequency of logging records (in seconds)


Mobile Traffic Usage periods

Different tabs of the Mobile Traffic section display mobile data usage values over different periods of time. This includes:

  • Today - data usage values for the current day
  • Current Week - weekly data usage values
  • Current Month - monthly data usage values
  • Data Limit Period - data usage values for the current data limit period (as set in the Network → Mobile → Mobile Data Limit page)
  • Total - data usage for the entire monitoring period (since Mobile Traffic Usage Logging was enabled)

The figure below is an example of the weekly data usage graph:

[[File:{{{periods_file}}}]]

Data usage graphs for other periods of time are essentially identical, with the exception that different time units (hours for daily usage, days of the week/month for weekly/monthly usage, months for total data usage) are displayed at the top of the graphs.

Take note that the Delete all data button (located in the bottom right corner of each graph) clears the entire data usage database, meaning that data usage values for all periods will be cleared and the data limit counter will be reset.

Obtaining data usage values from command line

Mobile data usage values can be obtained via command line interface with the help of mdcollectdctl. The usage for this command is described bellow:

usage: mdcollectdctl OPTIONS 
-cdayrx<SIM>                                        | GET today RX
-cdaytx<SIM>                                        | GET today TX
-clast24hrx<SIM>                                    | GET last 24h RX
-clast24htx<SIM>                                    | GET last 24h TX
-cweekrx<SIM>                                       | GET this week RX
-cweektx<SIM>                                       | GET this week TX
-pweekrx<SIM>                                       | GET last seven days RX
-pweektx<SIM>                                       | GET last seven days TX
-cmonthrx<SIM>                                      | GET this month RX
-cmonthtx<SIM>                                      | GET this month TX
-pmonthrx<SIM>                                      | GET last month(30 days) RX
-pmonthtx<SIM>                                      | GET last month(30 days) TX
-rx                                                 | GET current sim RX from reset 
-tx                                                 | GET current sim TX from reset 
-dayrx<SIM> <YEAR> <MONTH> <DAY>                    | GET entered day RX
-daytx<SIM> <YEAR> <MONTH> <DAY>                    | GET entered day TX
-monthrx<SIM> <YEAR> <MONTH>                        | GET entered month RX
-monthtx<SIM> <YEAR> <MONTH>                        | GET entered month TX
-fromtorx<SIM> <FROM_YEAR> <FROM_MONTH> <FROM_DAY>  | GET RX from entered date to today
-fromtotx<SIM> <FROM_YEAR> <FROM_MONTH> <FROM_DAY>  | GET TX from entered date to today
-fromtorx<SIM> <FROM_YEAR> <FROM_MONTH> <FROM_DAY>  <TO_YEAR> <TO_MONTH> <TO_DAY> | GET RX from entered date to entered date
-fromtotx<SIM> <FROM_YEAR> <FROM_MONTH> <FROM_DAY>  <TO_YEAR> <TO_MONTH> <TO_DAY> | GET TX from entered date to entered date
-clear                                              | Reset collected data 
-backup                                             | Backup database

The <SIM> value can be omitted when using the command on {{{name}}} routers To print the usage helper list, use mdcollectdctl --help.

Examples:

  • Get data usage value* for the current day:
    root@Teltonika:~# mdcollectdctl -cdayrx
    26558
  • Get data usage value* for the current month:
    root@Teltonika:~# mdcollectdctl -pmonthrx
    77701