Difference between revisions of "Template:Networking rutos manual events reporting"

From Teltonika Networks Wiki
(20 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<!-- Template uses {{{name}}}, {{{series}}}, {{{mobile}}} (0), {{{gps}}} (1), {{{wireless}}} (1) -->
+
<!-- Template uses {{{name}}}, {{{series}}}, {{{mobile}}} (0), {{{gps}}} (1), {{{wifi}}} (1) -->
{{Template:Networking_rutos_manual_fw_disclosure
+
{{Template: Networking_rutos_manual_fw_disclosure
| fw_version = {{{series}}}_R_00.02.03.1
+
| fw_version = {{{series}}}_R_00.02.06.1
 
| series    = {{{series}}}
 
| series    = {{{series}}}
 
}}
 
}}
Line 7: Line 7:
 
==Summary==
 
==Summary==
  
The '''Events Reporting''' section gives you the ability to configure rules that will inform you via {{#ifeq:{{{mobile}}}|0||SMS or}} email when certain events occur on your device. These events can be almost anything – configuration changes, reboots, new connections, various status updates, etc.  
+
The <b>Events Reporting</b> feature provides the possibility to configure rules that inform via {{#ifeq:{{{mobile}}}|0||SMS or }} email when certain trigger events occur.
  
 
This page is an overview of the Events Reporting section for {{{name}}} devices.
 
This page is an overview of the Events Reporting section for {{{name}}} devices.
  
===Events Reporting Rules===
+
==Events Reporting Rules==
----
 
'''Events Reporting Rules''' window display rules that you set up for such events as logins,
 
reboots, resets, connections, configuration changes and more, that you want to be informed about,
 
through {{#ifeq:{{{mobile}}}|0||SMS messages or}} emails. Click the '''Add''' button, it will redirect to
 
'''[[{{{name}}} Events Reporting#Events Reporting Configuration|Events Reporting Configuration]]'''
 
window for new rule, and click on '''Edit''' button [[File:Networking_rutx_manual_edit_button_v1.png]] to modify already existing rule.
 
 
 
[[File:Networking_rutx_manual_events_reporting_rules_v3.png|border|class=tlt-border]]
 
 
 
  
===Events Reporting Configuration===
+
The <b>Events Reporting Rules</b> section is used to manage existing Events Reporting rules and to add new ones. Events Reporting Rules trigger on certain, user specified events and send an {{#ifeq:{{{mobile}}}|0||SMS message or}} email to a specified number informing of the occurred event.
----
 
'''Events Reporting Configuration''' is used to customize Events Reporting rules.  
 
Here you can specify any event and type, you want to be informed about by your chosen message type.
 
  
{{#ifeq:{{{mobile}}}|0|[[File:Networking_rutx10_manual_events_reporting_configuration_v1.png|border|class=tlt-border]]|
+
All possible trigger events are listed in the table below.  
[[File:Networking_rutx09_manual_events_reporting_configuration_v1.png|border|class=tlt-border]]}}
 
<b>Note</b>: device values below <b>Message text on Event</b> field may be different on your device, this is an example of configuration window in RutOS devices.
 
  
 
+
<table class="nd-othertables_2" style="width: 100%;">
<table class="nd-mantable">
 
 
     <tr>
 
     <tr>
         <th>field name</th>
+
         <th width=35%>Event</th>
      <th>value</th>
+
        <th width=65%>Description</th>
      <th>description</th>
 
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
      <td>Enable</td>
+
        <td><b>Config change</b></td>
      <td>off {{!}} on; default: '''on'''</td>
+
        <td>Informs on changes to the device's configuration. Possible triggers are:
      <td>Toggles the rule ON or OFF.</td>
+
            <ul>
     </tr>
+
                <li><i>Any config change</i></li>
 +
                <li><i>Specific config change</i></li>
 +
            </ul>
 +
        </td>
 +
     </tr>{{#ifeq: {{{gps}}} | 1 |
 
     <tr>
 
     <tr>
         <td>Event</td>
+
         <td><b>GPS</b></td>
         <td>Config change {{!}} New DHCP client {{#ifeq:{{{mobile}}}|0||{{!}} Mobile data {{!}} SMS}} {{!}} Signal Strength {{!}} Reboot {{!}} SSH {{!}} WebUI {{!}} Ports state {{!}} Topology changes {{#ifeq:{{{series}}}|RUTX|{{!}} WAN Failover|}} {{#ifeq:{{{gps}}}|1|{{!}} GPS|}}; default: '''Config change'''</td>
+
         <td>Informs on when the device has entered or left a user defined geofence zone. Possible triggers are:
        <td>The event that you wish to receive information about.</td>
+
            <ul>
    </tr>
+
                <li><i>Entered geofence</i></li>
 +
                <li><i>Left geofence</i></li>
 +
                <li><i>All</i></li>
 +
            </ul>
 +
        </td>
 +
    </tr>|}}{{#ifeq: {{{mobile}}} | 1 |
 
     <tr>
 
     <tr>
         <td>Event type</td>
+
         <td><b>Mobile data</b></td>
        <td>Varies</td>
+
         <td>Informs on changes to the state of the device's mobile connection. Possible triggers are:
         <td>Specified event's type. This field changes in accordance with '''Event'''.</td>
+
            <ul>
     </tr>
+
                <li><i>Connected</i></li>
 +
                <li><i>Disconnected</i></li>
 +
                <li><i>All</i></li>
 +
            </ul>
 +
        </td>
 +
     </tr>|}}
 
     <tr>
 
     <tr>
         <td>Action</td>
+
         <td><b>New DHCP client</b></td>
         {{#ifeq:{{{mobile}}}|0|
+
         <td>Informs on new DHCP lease give outs. Possible triggers are:
        <td>Send email; default: '''Send email'''</td>
+
            <ul>
        |
+
                <li><i>Connected from LAN</i></li>{{#ifeq: {{{wifi}}} | 1 |
        <td>Send SMS {{!}} Send email; default: '''Send SMS'''</td>
+
                <li><i>Connected from WiFi</i></li>|}}
        }}
+
                <li><i>All</i></li>
         <td>Action that is to be taken after the specified event occurs.</td>
+
            </ul>
     </tr>
+
         </td>
 +
     </tr>{{#ifeq: {{{eth}}} | 1 |
 
     <tr>
 
     <tr>
         <td>Message text on Event</td>
+
         <td><b>Ports state</b></td>
         <td>string; default: '''Router name - %rn; Event type - %et; Event text - %ex; Time stamp - %ts;'''</td>
+
         <td>Informs on Ethernet port state (plugged in or unplugged) or speed (100 Mbps or 1000 Mbps) changes. Possible triggers are:
        <td>Specifies the text that the message will contain.</td>
+
            <ul>
     </tr>
+
                <li><i>Link speed</i></li>
{{#ifeq:{{{mobile}}}|0||
+
                <li><i>Link state</i></li>
 +
                <li><i>All</i></li>
 +
            </ul>
 +
        </td>
 +
     </tr>|}}
 
     <tr>
 
     <tr>
         <td><span style="color: #0054a6;">Send SMS:</span> Recipients</td>
+
         <td><b>Reboot</b></td>
         <td>Single number {{!}} Group; default: '''Single number'''</td>
+
         <td>Informs after device reboot occurrences. Possible triggers are:
        <td>Specifies the intended recipient, or user group. A guide on how to create a User group can be found in the SMS Utilities chapter, '''[[SMS_Utilities#User_Groups| User Groups]]''' section.</td>
+
            <ul>
     </tr>
+
                <li><i>From button</i></li>
 +
                <li><i>From Input/Output</i></li>
 +
                <li><i>From Ping Reboot</i></li>
 +
                <li><i>From Reboot Scheduler</i></li>
 +
                <li><i>From WebUI</i></li>
 +
                <li><i>All</i></li>
 +
            </ul>
 +
        </td>
 +
     </tr>{{#ifeq: {{{wifi}}} | 1 |
 
     <tr>
 
     <tr>
         <td><span style="color: #0054a6;">Send SMS:</span> Recipient's phone number</td>
+
         <td><b>Signal strength</b></td>
         <td>phone number; default: <b>none</b></td>
+
         <td>Informs on signal strength changes. Possible triggers are:
        <td>The intended recipient's phone number. The phone number must be entered in the international format, but without dash symbols or spaces, e.g., '''+37061234567'''</td>
+
            <ul>
     </tr>
+
                <li><i>- 121 dBm - 113 dBm</i></li>
}}
+
                <li><i>- 113 dBm - 98 dBm</i></li>
 +
                <li><i>- 98 dBm - 93 dBm</i></li>
 +
                <li><i>- 93 dBm - 75 dBm</i></li>
 +
                <li><i>- 75 dBm - 60 dBm</i></li>
 +
                <li><i>- 60 dBm - 50 dBm</i></li>
 +
                <li><i>All</i></li>
 +
            </ul>
 +
        </td>
 +
     </tr>|}}{{#ifeq: {{{mobile}}} | 1 |
 
     <tr>
 
     <tr>
         <td><span style="color: red;">Send email:</span> Subject</td>
+
         <td><b>SMS</b></td>
         <td>string; default: <b>none</b></td>
+
         <td>Informs on received SMS messages. Possible triggers are:
        <td>Subject of an email. Allowed characters (a-zA-Z0-9!@#$%&*+-/=?^_`{|}~. )</td>
+
            <ul>
     </tr>
+
                <li><i>SMS received</i></li>
 +
            </ul>
 +
        </td>
 +
     </tr>|}}
 
     <tr>
 
     <tr>
         <td><span style="color: red;">Send email:</span> Email user</td>
+
         <td><b>SSH</b></td>
         <td>Previously created Email user</td>
+
         <td>Informs on successful or unsuccessful SSH login attempts. Possible triggers are:
        <td>Choose non empty email configuration from email groups. Emails can be configured in '''[[Administration#Users_&_Recipients| Users & Recipients]]''' section.</td>
+
            <ul>
     </tr>
+
                <li><i>Successful authentication</i></li>
 +
                <li><i>Unsuccessful authentication</i></li>
 +
                <li><i>All</i></li>
 +
            </ul>
 +
        </td>
 +
     </tr>{{#ifeq: {{{eth}}} | 1 |
 
     <tr>
 
     <tr>
         <td><span style="color: red;">Send email:</span> Recipient's email address</td>
+
         <td><b>Topology state</b></td>
         <td>Email address; default: <b>none</b></td>
+
         <td>Informs on changes to the device's network topology. Possible triggers are:
        <td>The intended recipient's email address. Allowed characters (a-zA-Z0-9._%+@-)</td>
+
            <ul>
     </tr>
+
                <li><i>Topology changes</i></li>
 +
            </ul>
 +
        </td>
 +
     </tr>|}}{{#ifeq: {{{failover}}} | 1 |
 
     <tr>
 
     <tr>
         <td><span style="color: red;">Send email:</span> Send test email</td>
+
         <td><b>WAN failover</b></td>
         <td>-(interactive button)</td>
+
         <td>Informs on WAN failover occurrences. Possible triggers are:
        <td>Sends test email to chosen recipient.</td>
+
            <ul>
    </tr>
+
                <li><i>Switched to failover</i></li>
</table>
+
                <li><i>Switched to main</i></li>
 
+
                <li><i>All</i></li>
====Event Types and Sub-types====
+
            </ul>
----
+
         </td>
The example provided above is concerning the '''Config change''' Event and '''All''' Event types. This section is an overview of all other Event type and sub-types.
+
     </tr>|}}
 
 
=====Config change=====
 
----
 
 
 
<table class="nd-mantable">
 
    <tr>
 
        <th style="width: 250px">event sub-type</th>
 
      <th style="width: 904px">description</th>
 
    </tr>
 
    <tr>
 
      <td>All</td>
 
      <td>Sends a report message when any type of configuration changes are applied</td>
 
    </tr>
 
    <tr>
 
        <td>OpenVPN</td>
 
         <td>Sends a report message when any '''[[{{{name}}} VPN#OpenVPN|OpenVPN]]''' configuration changes are applied. For example, whenever a new OpenVPN instance is created, an OpenVPN instance gets disabled/enabled, an OpenVPN instance's protocol is changed from UDP to TCP or vice versa, etc.</td>
 
     </tr>
 
{{#ifeq:{{{mobile}}}|0||
 
    <tr>
 
        <td>SMS</td>
 
        <td>Sends a report message when any SMS related configuration changes are applied. For example, whenever a new '''[[{{{name}}}_Mobile_Utilities#SMS_Utilities|SMS Utilities]]''' rule is created or changed, changes are made to '''[[{{{name}}}_Mobile_Utilities#SMS_Gateway#Auto_Reply|Auto Reply]]''', etc.</td>
 
    </tr>
 
    <tr>
 
        <td>Multiwan</td>
 
        <td>Sends a report message when changes to WAN '''[[{{{name}}} WAN#Backup_Configuration|Backup]]''' configuration are applied. For example, whenever a switch from using Wired as main WAN to backup WAN occurs, Wireless is added as a Backup WAN, Health monitor configurations are changed, etc.</td>
 
    </tr>
 
 
     <tr>
 
     <tr>
         <td>Mobile</td>
+
         <td><b>WebUI</b></td>
         <td>Sends a report message when any '''[[{{{name}}} Mobile]]''' configuration changes are applied. For example, whenever Service mode, APN, Connection type is changed, etc.</td>
+
         <td>Informs on successful or unsuccessful HTTP/HTTPS login attempts. Possible triggers are:
 +
            <ul>
 +
                <li><i>Successful authentication</i></li>
 +
                <li><i>Unsuccessful authentication</i></li>
 +
                <li><i>All</i></li>
 +
            </ul>
 +
        </td>
 
     </tr>
 
     </tr>
    <tr>
 
        <td>Data limit</td>
 
        <td>Sends a report message when any '''[[{{{name}}} Mobile#Mobile_Data_Limit|Mobile Data Limit]]''' configuration changes are applied. For example, whenever new data limit is configured, data limit gets disabled/enabled on SIM1/SIM2, data limit period is changed, etc.</td>
 
    </tr>
 
}}
 
{{#ifeq:{{{gps}}}|1|
 
    <tr>
 
        <td>GPS</td>
 
        <td>Sends a report message when any configuration changes concerning '''[[{{{name}}} GPS]]''' are applied. For example, whenever GPS gets enabled/disabled, Remote host/IP address is changed, new '''[[{{{name}}} GPS#GPS_Geofencing|Geofencing]]''' area is defined, etc.</td>
 
    </tr>
 
|}}
 
    <tr>
 
        <td>Events reporting</td>
 
        <td>Sends a report message when any configuration changes to Events Reporting are applied. For example, whenever a new Events Reporting Rule is created, changed, deleted, etc.</td>
 
    </tr>
 
    <tr>
 
        <td>Periodic reboot</td>
 
        <td>Sends a report message when any configuration changes to '''[[{{{name}}} Auto_Reboot#Periodic_Reboot|Periodic Reboot]]''' are applied. For example, whenever Periodic Reboot gets enabled/disabled, Periodic Reboot interval is changed, etc.</td>
 
    </tr>
 
    <tr>
 
        <td>SNMP</td>
 
        <td>Sends a report message when any configuration changes to '''[[{{{name}}} SNMP]]''' are applied. For example, whenever SNMP service is enabled/disabled, SNMP remote access is enabled/disabled, SNMP port is changed, etc.</td>
 
    </tr>
 
    <tr>
 
        <td>Ping reboot</td>
 
        <td>Sends a report message when any configuration changes to '''[[{{{name}}} Auto_Reboot#Ping_Reboot|Ping Reboot]]''' are applied. For example, whenever Ping Reboot gets enabled/disabled, host to ping has changed, etc.</td>
 
    </tr>
 
{{#ifeq:{{{series}}}|RUTX|
 
    <tr>
 
        <td>Site blocking</td>
 
        <td> Sends a report message when any configuration changes to '''[[{{{name}}} Web_Filter#Site_Blocking|Site Blocking]]''' are applied. For example, whenever Whitelist is changed to Blacklist or vice versa, a new entry is added to Blacklist/Whitelist, etc.</td>
 
    </tr>
 
    <tr>
 
        <td>Content blocker</td>
 
        <td>Sends a report message when any configuration changes to '''[[{{{name}}} Web_Filter#Proxy_Based_Content_Blocker|Proxy Based Content Blocker]]''' are applied. For example, whenever Whitelist is changed to Blacklist or vice versa, a new entry is added to Blacklist/Whitelist, etc.</td>
 
    </tr>
 
|}}
 
{{#ifeq: {{{wireless}}}|1|
 
    <tr>
 
        <td>Hotspot</td>
 
        <td>Sends a report message when any configuration changes to '''[[{{{name}}} Hotspot]]''' are applied. For example, whenever Hotspot SSID was changed, Radius server was changed, Hotspot was enabled/disabled, etc.</td>
 
    </tr>
 
|}}
 
    <tr>
 
        <td>Input/Output</td>
 
        <td>Sends a report message when any configuration changes to '''[[{{{name}}} Input/Output|Input/Output]]''' are applied. For example, whenever scheduler is changed, etc.</td>
 
    </tr>
 
    <tr>
 
        <td>Profiles</td>
 
        <td>Sends a report message when a new '''[[{{{name}}} Profiles|Profile]]''' is added or deleted.</td>
 
    </tr>
 
    <tr>
 
        <td>DDNS</td>
 
        <td>Sends a report message when any configuration changes to '''[[{{{name}}} Dynamic DNS|Dynamic DNS]]''' are applied. For example, whenever a new DDNS instance is created, changed, deleted or edited.</td>
 
    </tr>
 
    <tr>
 
        <td>IPsec</td>
 
        <td>Sends a report message when any configuration changes to '''[[{{{name}}} VPN#IPsec|IPsec]]''' are applied. For example, a new IPsec instance is created, changed, deleted, etc.</td>
 
    </tr>
 
    <tr>
 
        <td>DHCP</td>
 
        <td>Sends a report message when any configuration changes to '''[[{{{name}}} LAN|DHCP]]''' are applied. For example, whenever DHCP Server is enabled/disabled, DHCP address range is changed.</td>
 
    </tr>
 
{{#ifeq:{{{series}}}|RUTX|
 
    <tr>
 
        <td>VRRP</td>
 
        <td>Sends a report message when any configuration changes to '''[[{{{name}}} VRRP]]''' are applied. For example, whenever VRRP is enabled/disabled, VRRP IP address is changed, etc.</td>
 
    </tr>
 
|}}
 
    <tr>
 
        <td>SSH</td>
 
        <td>Sends a report message when any configuration changes to SSH are applied.</td>
 
    </tr>
 
    <tr>
 
        <td>Network</td>
 
        <td>Sends a report message when any Network related configuration changes are applied. For example, whenever Main WAN is changed, LAN IP address is changed, a Wi-Fi Access Point is enabled/disabled, etc.</td>
 
    </tr>
 
{{#ifeq:{{{wireless}}}|1|
 
    <tr>
 
        <td>Wireless</td>
 
        <td>Sends a report message when any configuration changes to '''[[{{{name}}} Wireless]]''' are applied. For example, a new Wi-Fi Access point is created, deleted, enabled/disabled, SSID is changed, etc.</td>
 
    </tr>
 
|}}
 
    <tr>
 
        <td>Firewall</td>
 
        <td>Sends a report message when any configuration changes to '''[[{{{name}}} Firewall]]''' are applied. For example, a new Traffic rule is added, a new SNAT rule is added, a rule is disabled/enabled, etc.</td>
 
    </tr>
 
    <tr>
 
        <td>NTP</td>
 
        <td>Sends a report message when any configuration changes to '''[[{{{name}}} NTP]]''' are applied. For example, whenever NTP is enabled/disabled, Time zone is changed, etc.</td>
 
    </tr>
 
{{#ifeq:{{{series}}}|RUTX|
 
    <tr>
 
        <td>UPNP</td>
 
        <td>Sends a report message when any configuration changes to '''[[{{{name}}} UPNP]]''' are applied. For example, whenever usable port range is changed, etc.</td>
 
    </tr>
 
|}}
 
 
</table>
 
</table>
  
=====New DHCP client=====
+
==Events Reporting Configuration==
----
 
  
<table class="nd-mantable">
+
The Events Reporting Rules list is empty by default. Before you can begin configuration you must add at least one new rule. This can be done by clicking the 'Add' button:
    <tr>
 
        <th style="width: 250px">event sub-type</th>
 
      <th style="width: 904px">description</th>
 
    </tr>
 
    <tr>
 
      <td>All</td>
 
      <td>Sends a report message when a new devices is connected to the device either via LAN or Wi-Fi.</td>
 
    </tr>
 
{{#ifeq:{{{wireless}}}|1|
 
    <tr>
 
      <td>Connected from WiFi</td>
 
      <td>Sends a report message when a new device is connected to the device via Wi-Fi.</td>
 
    </tr>
 
}}
 
    <tr>
 
      <td>Connected from LAN</td>
 
      <td>Sends a report message when a new device is connected to the device via LAN port.</td>
 
    </tr>
 
</table>
 
  
{{#ifeq:{{{mobile}}}|0||
+
[[File:Networking_rutos_manual_events_reporting_events_reporting_rules_add_button.png|border|class=tlt-border]]
=====Mobile Data=====
 
----
 
  
<table class="nd-mantable">
+
After adding a rule you should be redirected to its configuration page.
    <tr>
+
{{#ifeq: {{{mobile}}} | 1 | ===Send SMS===
        <th style="width: 250px">event sub-type</th>
 
      <th style="width: 904px">description</th>
 
    </tr>
 
    <tr>
 
      <td>All</td>
 
      <td>Sends a report message when mobile data connection is achieved or lost.</td>
 
    </tr>
 
    <tr>
 
      <td>Connected</td>
 
      <td>Sends a report message when mobile data connection is achieved.</td>
 
    </tr>
 
    <tr>
 
      <td>Disconnected</td>
 
      <td>Sends a report message when mobile data connection is lost.</td>
 
    </tr>
 
</table>
 
 
 
=====SMS=====
 
 
----
 
----
 +
One of the two Events Reporting types is <b>via SMS messages</b>. When an Events Reporting rule is configured to send SMS, the devices will send out an SMS message from the currently active SIM card to the phone number specified in a rule's configuration.
  
<table class="nd-mantable">
+
[[File:Networking_rutos_manual_events_reporting_events_reporting_rules_send_sms.png|border|class=tlt-border]]
    <tr>
 
        <th style="width: 250px">event sub-type</th>
 
      <th style="width: 904px">description</th>
 
    </tr>
 
    <tr>
 
      <td>SMS received</td>
 
      <td>Sends a report message when the device receives a new SMS message.</td>
 
    </tr>
 
</table>
 
 
 
=====Signal Strength=====
 
----
 
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
 
     <tr>
 
     <tr>
         <th style="width: 250px">event sub-type</th>
+
         <th>Field</th>
       <th style="width: 904px">description</th>
+
       <th>Value</th>
 +
      <th>Description</th>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
       <td>All</td>
+
       <td>Enable</td>
       <td>Sends a report message when the device '''[[RSSI]]''' value leaves any one of the below specified ranges.</td>
+
       <td>off {{!}} on; default: <b>on</b></td>
 +
      <td>Turns the rule on or off.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
      <td>-121 dBm -113 dBm</td>
+
        <td>Event</td>
      <td>Sends a report message when the device RSSI value leaves the -121 dBm to -113 dBm range.</td>
+
        <td>Config change {{!}} New DHCP client {{!}} Mobile data {{!}} Send SMS {{!}} Signal Strength {{!}} Reboot {{!}} SSH {{!}} WebUI {{#ifeq:{{{eth}}}|1|{{!}} Ports state {{!}} Topology changes |}}{{#ifeq:{{{failover}}}|1|{{!}} WAN Failover |}}{{#ifeq:{{{gps}}}|1|{{!}} GPS|}}; default: <b>Config change</b></td>
 +
        <td>The event that you wish to receive notifications on.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
      <td>-113 dBm -98 dBm</td>
+
        <td>Event type</td>
      <td>Sends a report message when the device RSSI value leaves the -113 dBm to -98 dBm range.</td>
+
        <td>Varies</td>
 +
        <td>Specific event sub-type that will trigger the rule. The value of this field changes in accordance with the selection of the 'Event' field.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
      <td>-98 dBm -93 dBm</td>
+
        <td>Action</td>
      <td>Sends a report message when the device RSSI value leaves the -98 dBm to -93 dBm range.</td>
+
        <td>Send SMS {{!}} Send email; default: <b>Send SMS</b></td>
 +
        <td>Selects the method of reporting on the specified event.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
      <td>-93 dBm -75 dBm</td>
+
        <td>Message text on Event</td>
      <td>Sends a report message when the device RSSI value leaves the -93 dBm to -75 dBm range.</td>
+
        <td>string; default: <b>Router name - %rn; Event type - %et; Event text - %ex; Time stamp - %ts;</b></td>
 +
        <td>Text to be included in the body of the report message.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
      <td>-75 dBm -60 dBm</td>
+
        <td>Recipients</td>
      <td>Sends a report message when the device RSSI value leaves the -75 dBm to -60 dBm range.</td>
+
        <td>Single number {{!}} Group; default: <b>Single number</b></td>
 +
        <td>Specifies whether the recipient should be a single number or a group of numbers.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
      <td>-60 dBm -50 dBm</td>
+
        <td>Recipient's phone number</td>
      <td>Sends a report message when the device RSSI value leaves the -60 dBm to -50 dBm range.</td>
+
        <td>phone number; default: <b>none</b></td>
 +
        <td>Phone number of the recipient. The phone number must be entered in the international format, without spaces or other symbols (for example: <i>+37068163951</i>)</td>
 
     </tr>
 
     </tr>
 
</table>
 
</table>
}}
+
|}}
 
+
<h3>Send email</h3>
=====Reboot=====
 
 
----
 
----
 +
When an Events Reporting rule is configured to <b>send emails</b>, the device (this {{{name}}}) will connect to an existing email account when a user specified trigger event occurs and send an email to another email address informing of the occurred event.
  
<table class="nd-mantable">
+
In order to send emails, the device requires access to an existing email account. You can configure email accounts in the <b>System → Administration → [[{{{name}}} Administration#Recipients|Recipients]]</b> page. Allowing access to less secure apps may be required for some email service providers.
    <tr>
 
        <th style="width: 250px">event sub-type</th>
 
      <th style="width: 904px">description</th>
 
    </tr>
 
    <tr>
 
      <td>All</td>
 
      <td>Sends a report message when the device starts up after any type of reboot (except factory reset).</td>
 
    </tr>
 
    <tr>
 
      <td>From Web UI</td>
 
      <td>Sends a report message when the device starts up after a reboot command is initiated from the device WebUI Administration->Reboot section.</td>
 
    </tr>
 
    <tr>
 
      <td>From input/output</td>
 
      <td>Sends a report message when the device starts up after a reboot command is initiated via Input/Output.</td>
 
    </tr>
 
    <tr>
 
      <td>From ping reboot</td>
 
      <td>Sends a report message when the device starts up after a reboot command is initiated by the Ping Reboot function.</td>
 
    </tr>
 
    <tr>
 
      <td>From periodic reboot</td>
 
      <td>Sends a report message when the device starts up after a reboot command is initiated by the Periodic Reboot function.</td>
 
    </tr>
 
    <tr>
 
      <td>From button</td>
 
      <td>Sends a report message when the device starts up after being restarted by the press of the physical button located on the device.</td>
 
    </tr>
 
</table>
 
  
=====SSH=====
+
[[File:Networking_rutos_manual_events_reporting_events_reporting_rules_send_email.png|border|class=tlt-border]]
----
 
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
 
     <tr>
 
     <tr>
         <th style="width: 250px">event sub-type</th>
+
         <th>Field</th>
       <th style="width: 904px">description</th>
+
       <th>Value</th>
 +
      <th>Description</th>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
       <td>All</td>
+
       <td>Enable</td>
       <td>Sends a report message when someone connects to the device via SSH (either successfully or unsuccessfully).</td>
+
       <td>off | on; default: <b>on</b></td>
 +
      <td>Turns the rule on or off.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
      <td>Successful authentication</td>
+
        <td>Event</td>
      <td>Sends a report message when someone successfully connects to the device via SSH.</td>
+
        <td>Config change {{!}} New DHCP client {{#ifeq:{{{mobile}}}|1|{{!}} Mobile data {{!}} Send SMS {{!}} Signal Strength {{!}}|{{!}}}} Reboot {{!}} SSH {{!}} WebUI {{#ifeq:{{{eth}}}|1|{{!}} Ports state {{!}} Topology changes |}}{{#ifeq:{{{failover}}}|1|{{!}} WAN Failover |}}{{#ifeq:{{{gps}}}|1|{{!}} GPS|}}; default: <b>Config change</b></td>
 +
        <td>The event that you wish to receive notifications on.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
      <td>Unsuccessful authentication</td>
+
        <td>Event type</td>
      <td>Sends a report message when someone unsuccessfully tries to connect to the device via SSH.</td>
+
        <td>Varies</td>
    </tr>
+
         <td>Specific event sub-type that will trigger the rule. The value of this field changes in accordance with the selection of the 'Event' field.</td>
</table>
 
 
 
=====WebUI=====
 
----
 
 
 
<table class="nd-mantable">
 
    <tr>
 
         <th style="width: 250px">event sub-type</th>
 
      <th style="width: 904px">description</th>
 
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
      <td>All</td>
+
        <td>Action</td>
      <td>Sends a report message when someone connects to the device via HTTP or HTTPS (either successfully or unsuccessfully).</td>
+
        <td>{{#ifeq:{{{mobile}}}|1|Send SMS {{!}} |}}Send email; default: <b>{{#ifeq:{{{mobile}}}|1|Send SMS|Send email}}</b></td>
 +
        <td>Selects the method of reporting on the specified event.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
      <td>Successful authentication</td>
+
        <td>Subject</td>
      <td>Sends a report message when someone successfully connects to the device via HTTP or HTTPS.</td>
+
        <td>string; default: <b>none</b></td>
 +
        <td>Subject of the sent email.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
      <td>Unsuccessful authentication</td>
+
        <td>Message text on Event</td>
      <td>Sends a report message when someone unsuccessfully tries to connect to the device via HTTP or HTTPS.</td>
+
        <td>string; default: <b>Router name - %rn; Event type - %et; Event text - %ex; Time stamp - %ts;</b></td>
    </tr>
+
        <td>Text to be included in the body of the report email.</td>
</table>
 
 
 
{{#ifeq:{{{series}}}|TRB14X||
 
=====Ports State=====
 
----
 
 
 
<table class="nd-mantable">
 
    <tr>
 
        <th style="width: 250px">event sub-type</th>
 
      <th style="width: 904px">description</th>
 
    </tr>
 
    <tr>
 
      <td>All</td>
 
      <td>Sends a report message when a device is either plugged in or unplugged from one of the device LAN ports.</td>
 
    </tr>
 
    <tr>
 
      <td>Link state</td>
 
      <td>Sends a report message when a device is plugged or unplugged from one of the device Ethernet ports.</td>
 
    </tr>
 
    <tr>
 
      <td>Link speed</td>
 
      <td>Sends a report message when Port Link speed is decided.</td>
 
    </tr>
 
</table>
 
 
 
=====Topology state=====
 
----
 
 
 
<table class="nd-mantable">
 
    <tr>
 
        <th style="width: 250px">event sub-type</th>
 
      <th style="width: 904px">description</th>
 
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
      <td>Topology changes</td>
+
        <td>Email account</td>
      <td>Sends a report message when there are changes in network topology.</td>
+
        <td>email account; default: <b>none</b></td>
    </tr>
+
        <td>The account that will be used to send an email.</td>
</table>
 
}}
 
 
 
{{#ifeq:{{{series}}}|RUTX|
 
=====WAN Failover=====
 
----
 
 
 
<table class="nd-mantable">
 
    <tr>
 
        <th style="width: 250px">event sub-type</th>
 
      <th style="width: 904px">description</th>
 
    </tr>
 
    <tr>
 
      <td>All</td>
 
      <td>Sends a report message when device WAN switches to Failover or back to main WAN.</td>
 
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
      <td>Switches to main</td>
+
        <td>Recipient's email address</td>
      <td>Sends a report message when device switches from failover to main WAN.</td>
+
        <td>email address; default: <b>none</b></td>
 +
        <td>Email address of the recipient.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
      <td>Switches to failover</td>
+
        <td>Send test email</td>
      <td>Sends a report message when device switches to failover WAN.</td>
+
        <td>- (interactive button)</td>
 +
        <td>Sends an email based on the current configuration. This is used to test whether the configuration works as intended.</td>
 
     </tr>
 
     </tr>
 
</table>
 
</table>
|}}
 
 
{{#ifeq:{{{gps}}}|1|
 
=====GPS=====
 
----
 
  
<table class="nd-mantable">
 
    <tr>
 
        <th style="width: 250px">event sub-type</th>
 
      <th style="width: 904px">description</th>
 
    </tr>
 
    <tr>
 
      <td>All</td>
 
      <td>Sends a report message when the device moves in and out of the GPS Geofence area.</td>
 
    </tr>
 
    <tr>
 
      <td>Left geofence</td>
 
      <td>Sends a report message when the device leaves the GPS Geofence area.</td>
 
    </tr>
 
    <tr>
 
      <td>Entered geofence</td>
 
      <td>Sends a report message when the device enter the GPS Geofence area.</td>
 
    </tr>
 
</table>
 
|}}
 
 
[[Category:{{{name}}} Services section]]
 
[[Category:{{{name}}} Services section]]

Revision as of 13:22, 15 February 2021

Template:Networking rutos manual fw disclosure

Summary

The Events Reporting feature provides the possibility to configure rules that inform via SMS or email when certain trigger events occur.

This page is an overview of the Events Reporting section for {{{name}}} devices.

Events Reporting Rules

The Events Reporting Rules section is used to manage existing Events Reporting rules and to add new ones. Events Reporting Rules trigger on certain, user specified events and send an SMS message or email to a specified number informing of the occurred event.

All possible trigger events are listed in the table below.

Event Description
Config change Informs on changes to the device's configuration. Possible triggers are:
  • Any config change
  • Specific config change
New DHCP client Informs on new DHCP lease give outs. Possible triggers are:
  • Connected from LAN
  • All
Reboot Informs after device reboot occurrences. Possible triggers are:
  • From button
  • From Input/Output
  • From Ping Reboot
  • From Reboot Scheduler
  • From WebUI
  • All
SSH Informs on successful or unsuccessful SSH login attempts. Possible triggers are:
  • Successful authentication
  • Unsuccessful authentication
  • All
WebUI Informs on successful or unsuccessful HTTP/HTTPS login attempts. Possible triggers are:
  • Successful authentication
  • Unsuccessful authentication
  • All

Events Reporting Configuration

The Events Reporting Rules list is empty by default. Before you can begin configuration you must add at least one new rule. This can be done by clicking the 'Add' button:

Networking rutos manual events reporting events reporting rules add button.png

After adding a rule you should be redirected to its configuration page.

Send email


When an Events Reporting rule is configured to send emails, the device (this {{{name}}}) will connect to an existing email account when a user specified trigger event occurs and send an email to another email address informing of the occurred event.

In order to send emails, the device requires access to an existing email account. You can configure email accounts in the System → Administration → [[{{{name}}} Administration#Recipients|Recipients]] page. Allowing access to less secure apps may be required for some email service providers.

Networking rutos manual events reporting events reporting rules send email.png

Field Value Description
Enable off | on; default: on Turns the rule on or off.
Event Config change | New DHCP client | Reboot | SSH | WebUI ; default: Config change The event that you wish to receive notifications on.
Event type Varies Specific event sub-type that will trigger the rule. The value of this field changes in accordance with the selection of the 'Event' field.
Action Send email; default: Send email Selects the method of reporting on the specified event.
Subject string; default: none Subject of the sent email.
Message text on Event string; default: Router name - %rn; Event type - %et; Event text - %ex; Time stamp - %ts; Text to be included in the body of the report email.
Email account email account; default: none The account that will be used to send an email.
Recipient's email address email address; default: none Email address of the recipient.
Send test email - (interactive button) Sends an email based on the current configuration. This is used to test whether the configuration works as intended.

[[Category:{{{name}}} Services section]]