View source for Template:Networking rut manual mobile traffic

==Summary==

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

{{Template: Networking_rutxxx_manual_fw_disclosure| fw_version = {{{fw_version}}}}}

<!-- ==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}}}]]

<table class="nd-mantable">
    <tr>
        <th>field name</th>
       	<th>value</th>
       	<th>description</th>
    </tr>
    <tr>
    	<td>Enable</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>
    </tr>
    <tr>
    	<td>Interval between records (sec)</td>
        <td>integer [3..∞]; Default: <b>10</b></td>
        <td>Specifies the frequency of logging records (in seconds)</td>
    </tr>
</table> -->

==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 interfaces|command line interface]] with the help of '''mdcollectdctl'''. The usage for this command is described bellow:
<pre>
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
</pre>
{{#ifeq: {{{series}}} | RUT9xx || The <SIM> value can be omitted when using the command on {{{name}}} routers}}
To print the usage helper list, use '''mdcollectdctl --help'''.

'''Examples''':
{{#ifeq: {{{series}}} | RUT9xx | {{Template: Networking_rut9xx_manual_mobile_traffic_cli_examples}} | {{Template: Networking_rut2xx_rut850_manual_mobile_traffic_cli_examples}}}}
{{Template: Networking_device_manual_modbus_modbus_tcp_get_parameters_table_asterisk}}

[[Category:{{{name}}} WebUI]]