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

From Teltonika Networks Wiki
Line 24: Line 24:
 
     <tr>
 
     <tr>
 
         <td><b>Config change</b></td>
 
         <td><b>Config change</b></td>
         <td>Informs on changes to the device's configuration. Possible trigger are:
+
         <td>Informs on changes to the device's configuration. Possible triggers are:
 
             <ul>
 
             <ul>
                 <li>Any config change</li>
+
                 <li><i>Any config change</i></li>
                 <li>Specific config change</li>
+
                 <li><i>Specific config change</i></li>
 
             </ul>
 
             </ul>
 
         </td>
 
         </td>
Line 33: Line 33:
 
     <tr>
 
     <tr>
 
         <td><b>GPS</b></td>
 
         <td><b>GPS</b></td>
         <td>Informs on when the device has entered or left a user defined geofence zone. Possible trigger are:
+
         <td>Informs on when the device has entered or left a user defined geofence zone. Possible triggers are:
 
             <ul>
 
             <ul>
                 <li>All</li>
+
                 <li><i>All</i></li>
                 <li>Left geofence</li>
+
                 <li><i>Left geofence</i></li>
                 <li>Entered geofence</li>
+
                 <li><i>Entered geofence</i></li>
 
             </ul>
 
             </ul>
 
         </td>
 
         </td>
Line 43: Line 43:
 
     <tr>
 
     <tr>
 
         <td><b>Mobile</b></td>
 
         <td><b>Mobile</b></td>
         <td>Informs on changes to the state of the device's mobile connection. Possible trigger are:
+
         <td>Informs on changes to the state of the device's mobile connection. Possible triggers are:
 
             <ul>
 
             <ul>
                 <li>All</li>
+
                 <li><i>All</i></li>
                 <li>Connected</li>
+
                 <li><i>Connected</i></li>
                 <li>Disconnected</li>
+
                 <li><i>Disconnected</i></li>
 
             </ul>
 
             </ul>
 
         </td>
 
         </td>
Line 53: Line 53:
 
     <tr>
 
     <tr>
 
         <td><b>New DHCP client</b></td>
 
         <td><b>New DHCP client</b></td>
         <td>Informs on new DHCP lease give outs. Possible values are:
+
         <td>Informs on new DHCP lease give outs. Possible triggers are:
 
             <ul>
 
             <ul>
                 <li>All</li>{{#ifeq: {{{wifi}}} | 1 |
+
                 <li><i>All</i></li>{{#ifeq: {{{wifi}}} | 1 |
                 <li>Connected from WiFi</li>|}}
+
                 <li><i>Connected from WiFi</i></li>|}}
                 <li>Connected from LAN</li>
+
                 <li><i>Connected from LAN</i></li>
 
             </ul>
 
             </ul>
 
         </td>
 
         </td>
Line 63: Line 63:
 
     <tr>
 
     <tr>
 
         <td><b>Ports state</b></td>
 
         <td><b>Ports state</b></td>
         <td>Informs on Ethernet port state (plugged in or unplugged) or speed (100 Mbps or 1000 Mbps) changes. Possible values are:
+
         <td>Informs on Ethernet port state (plugged in or unplugged) or speed (100 Mbps or 1000 Mbps) changes. Possible triggers are:
 
             <ul>
 
             <ul>
                 <li>All</li>
+
                 <li><i>All</i></li>
                 <li>Link state</li>
+
                 <li><i>Link state</i></li>
                 <li>Link speed</li>
+
                 <li><i>Link speed</i></li>
 
             </ul>
 
             </ul>
 
         </td>
 
         </td>
Line 73: Line 73:
 
     <tr>
 
     <tr>
 
         <td><b>Reboot</b></td>
 
         <td><b>Reboot</b></td>
         <td>Informs after device reboot occurrences. Possible values are:
+
         <td>Informs after device reboot occurrences. Possible triggers are:
 
             <ul>
 
             <ul>
                 <li>All</li>
+
                 <li><i>All</i></li>
                 <li>From WebUI</li>
+
                 <li><i>From WebUI</i></li>
                 <li>From Input/Output</li>
+
                 <li><i>From Input/Output</i></li>
                 <li>From Ping Reboot</li>
+
                 <li><i>From Ping Reboot</i></li>
                 <li>From Reboot Scheduler</li>
+
                 <li><i>From Reboot Scheduler</i></li>
                 <li>From button</li>
+
                 <li><i>From button</i></li>
 
             </ul>
 
             </ul>
 
         </td>
 
         </td>
Line 86: Line 86:
 
     <tr>
 
     <tr>
 
         <td><b>Signal strength</b></td>
 
         <td><b>Signal strength</b></td>
         <td>Informs on signal strength changes. Possible values are:
+
         <td>Informs on signal strength changes. Possible triggers are:
 
             <ul>
 
             <ul>
                 <li>All</li>
+
                 <li><i>All</i></li>
                 <li>- 121 dBm - 113 dBm</li>
+
                 <li><i>- 121 dBm - 113 dBm</i></li>
                 <li>- 113 dBm - 98 dBm</li>
+
                 <li><i>- 113 dBm - 98 dBm</i></li>
                 <li>- 98 dBm - 93 dBm</li>
+
                 <li><i>- 98 dBm - 93 dBm</i></li>
                 <li>- 93 dBm - 75 dBm</li>
+
                 <li><i>- 93 dBm - 75 dBm</i></li>
                 <li>- 75 dBm - 60 dBm</li>
+
                 <li><i>- 75 dBm - 60 dBm</i></li>
                 <li>- 60 dBm - 50 dBm</li>
+
                 <li><i>- 60 dBm - 50 dBm</i></li>
 
             </ul>
 
             </ul>
 
         </td>
 
         </td>
Line 100: Line 100:
 
     <tr>
 
     <tr>
 
         <td><b>SMS</b></td>
 
         <td><b>SMS</b></td>
         <td>Informs on received SMS messages. Possible values are:
+
         <td>Informs on received SMS messages. Possible triggers are:
 
             <ul>
 
             <ul>
                 <li>SMS received</li>
+
                 <li><i>SMS received</i></li>
 
             </ul>
 
             </ul>
 
         </td>
 
         </td>
Line 108: Line 108:
 
     <tr>
 
     <tr>
 
         <td><b>SSH</b></td>
 
         <td><b>SSH</b></td>
         <td>Informs on successful or unsuccessful SSH login attempts. Possible values are:
+
         <td>Informs on successful or unsuccessful SSH login attempts. Possible triggers are:
 
             <ul>
 
             <ul>
                 <li>All</li>
+
                 <li><i>All</i></li>
                 <li>Successful authentication</li>
+
                 <li><i>Successful authentication</i></li>
                 <li>Unsuccessful authentication</li>
+
                 <li><i>Unsuccessful authentication</i></li>
 
             </ul>
 
             </ul>
 
         </td>
 
         </td>
Line 120: Line 120:
 
         <td>
 
         <td>
 
             <ul>
 
             <ul>
                 <li>Topology changes</li>
+
                 <li><i>Topology changes</i></li>
 
             </ul>
 
             </ul>
 
         </td>
 
         </td>
Line 126: Line 126:
 
     <tr>
 
     <tr>
 
         <td><b>WAN failover</b></td>
 
         <td><b>WAN failover</b></td>
         <td>Informs on WAN failover occurrences. Possible values are:
+
         <td>Informs on WAN failover occurrences. Possible triggers are:
 
             <ul>
 
             <ul>
                 <li>All</li>
+
                 <li><i>All</i></li>
                 <li>Switched to main</li>
+
                 <li><i>Switched to main</i></li>
                 <li>Switched to failover</li>
+
                 <li><i>Switched to failover</i></li>
 
             </ul>
 
             </ul>
 
         </td>
 
         </td>
Line 136: Line 136:
 
     <tr>
 
     <tr>
 
         <td><b>WebUI</b></td>
 
         <td><b>WebUI</b></td>
         <td>Informs on successful or unsuccessful HTTP/HTTPS login attempts. Possible values are:
+
         <td>Informs on successful or unsuccessful HTTP/HTTPS login attempts. Possible triggers are:
 
             <ul>
 
             <ul>
                 <li>All</li>
+
                 <li><i>All</i></li>
                 <li>Successful authentication</li>
+
                 <li><i>Successful authentication</i></li>
                 <li>Unsuccessful authentication</li>
+
                 <li><i>Unsuccessful authentication</i></li>
 
             </ul>
 
             </ul>
 
         </td>
 
         </td>

Revision as of 09:49, 12 October 2020

Template:Networking rutos manual fw disclosure

Summary

The Events Reporting feature provides the possibility to configure rules that inform of via SMS oremail 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 window 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 oremail 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:
  • All
  • Connected from LAN
Reboot Informs after device reboot occurrences. Possible triggers are:
  • All
  • From WebUI
  • From Input/Output
  • From Ping Reboot
  • From Reboot Scheduler
  • From button
SSH Informs on successful or unsuccessful SSH login attempts. Possible triggers are:
  • All
  • Successful authentication
  • Unsuccessful authentication
WebUI Informs on successful or unsuccessful HTTP/HTTPS login attempts. Possible triggers are:
  • All
  • Successful authentication
  • Unsuccessful authentication

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.

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 SMS | Send email; default: Send SMS Selects the method of reporting on the specified event. 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 report message. Recipients Single number | Group; default: Single number Specifies whether the recipient should be a single number or a group of numbers. Recipient's phone number phone number; default: none Phone number of the recipient. The phone number must be entered in the international format, without spaces or other symbols (for example: +37068163951)

|}}

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.

Field Value Description
Enable off | on; default: on Turns the rule on or off.
Event Config change | New DHCP client | Mobile data | SMS}} | Signal Strength | 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 SMS | Send email; default: Send SMS 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 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]]