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

From Teltonika Networks Wiki
 
(12 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<!-- Template uses {{{name}}}, {{{series}}}, {{{mobile}}} (0), {{{gps}}} (1), {{{wifi}}} (1) -->
+
<!-- Template uses {{{name}}}, {{{series}}}, {{{mobile}}} (0), {{{gps}}} (1), {{{wifi}}} (1), {{eth}} (1), {{simswitch}} -->
{{Template: Networking_rutos_manual_fw_disclosure
+
{{Template: Networking_device_manual_fw_disclosure
| fw_version = {{{series}}}_R_00.07.01
+
| series = {{{series}}}
| series     = {{{series}}}
+
| name  = {{{name}}}
 +
| fw_version ={{Template: Networking_device_manual_latest_fw
 +
| series = {{{series}}}
 +
| name  = {{{name}}}
 +
}}
 
}}
 
}}
{{#ifeq: {{{series}}} | RUT9 |<br><i><b>Note</b>: <b>[[{{{name}}} Events Log (legacy WebUI)|click here]]</b> for the old style WebUI (FW version RUT9XX_R_00.06.08.3 and earlier) user manual page.</i>|}}
+
{{#ifeq: {{{series}}} | RUT9 |<br><i><b>Note</b>: <b>[[{{{name}}} Events Log (legacy WebUI)|click here]]</b> for the old style WebUI (FW version {{Template: Networking_device_manual_latest_fw | series = RUT9XX}} and earlier) user manual page.</i>|}}
{{#ifeq: {{{series}}} | RUT2 |<br><i><b>Note</b>: <b>[[{{{name}}} Events Log (legacy WebUI)|click here]]</b> for the old style WebUI (FW version RUT2XX_R_00.01.14.1 and earlier) user manual page.</i>|}}
+
{{#ifeq: {{{series}}} | RUT2 |<br><i><b>Note</b>: <b>[[{{{name}}} Events Log (legacy WebUI)|click here]]</b> for the old style WebUI (FW version {{Template: Networking_device_manual_latest_fw | series = RUT2XX}} and earlier) user manual page.</i>|}}
 
==Summary==
 
==Summary==
  
Line 21: Line 25:
 
     <tr>
 
     <tr>
 
         <th width=35%>Event</th>
 
         <th width=35%>Event</th>
         <th width=65%>Description</th>
+
         <th width=65%>Event subtype</th>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
Line 58: Line 62:
 
                 <li><i>Connected from LAN</i></li>{{#ifeq: {{{wifi}}} | 1 |
 
                 <li><i>Connected from LAN</i></li>{{#ifeq: {{{wifi}}} | 1 |
 
                 <li><i>Connected from WiFi</i></li>|}}
 
                 <li><i>Connected from WiFi</i></li>|}}
                <li><i>All</i></li>
 
 
             </ul>
 
             </ul>
 
         </td>
 
         </td>
Line 68: Line 71:
 
                 <li><i>Link speed</i></li>
 
                 <li><i>Link speed</i></li>
 
                 <li><i>Link state</i></li>
 
                 <li><i>Link state</i></li>
                 <li><i>All</i></li>
+
                 <li><i>Unplugged</i></li>
 +
                <li><i>Plugged in</i></li>{{#switch: {{{series}}} | RUTX | RUTM | RUT30X | #default =
 +
                <li><i>LAN1</i></li>
 +
                <li><i>LAN2</i></li>
 +
                <li><i>LAN3</i></li>
 +
                <li><i>LAN4</i></li>
 +
                <li><i>WAN</i></li>| RUT2 | RUT2M | RUT36X | TCR1 | TRB1 | TRB2 | TRB2M | TRB5 =
 +
                <li><i>LAN1</i></li>
 +
                <li><i>WAN</i></li>| RUT9 | RUT9M =
 +
                <li><i>LAN1</i></li>
 +
                <li><i>LAN2</i></li>
 +
                <li><i>LAN3</i></li>
 +
                <li><i>WAN</i></li>}}
 
             </ul>
 
             </ul>
 
         </td>
 
         </td>
Line 79: Line 94:
 
                 <li><i>From Input/Output</i></li>
 
                 <li><i>From Input/Output</i></li>
 
                 <li><i>From Ping Reboot</i></li>
 
                 <li><i>From Ping Reboot</i></li>
 +
                <li><i>From wget Reboot</i></li>
 
                 <li><i>From Reboot Scheduler</i></li>
 
                 <li><i>From Reboot Scheduler</i></li>
 
                 <li><i>From WebUI</i></li>
 
                 <li><i>From WebUI</i></li>
 +
                <li><i>From SMS</i></li>
 
                 <li><i>All</i></li>
 
                 <li><i>All</i></li>
 
             </ul>
 
             </ul>
 
         </td>
 
         </td>
     </tr>{{#ifeq: {{{wifi}}} | 1 |
+
    </tr>
 +
    <tr>
 +
        <td><b>Startup</b></td>
 +
        <td>Informs when device startup completed. Possible triggers are:
 +
            <ul>
 +
                <li><i>Device startup completed</i></li>
 +
            </ul>
 +
        </td>
 +
     </tr>{{#ifeq: {{{mobile}}} | 1 |
 
     <tr>
 
     <tr>
 
         <td><b>Signal strength</b></td>
 
         <td><b>Signal strength</b></td>
Line 98: Line 123:
 
             </ul>
 
             </ul>
 
         </td>
 
         </td>
     </tr>|}}{{#ifeq: {{{mobile}}} | 1 |
+
     </tr>
 
     <tr>
 
     <tr>
 
         <td><b>SMS</b></td>
 
         <td><b>SMS</b></td>
Line 106: Line 131:
 
             </ul>
 
             </ul>
 
         </td>
 
         </td>
     </tr>|}}
+
     </tr>{{#ifeq: {{{simswitch}}} | 1 |
 +
    <tr>
 +
        <td><b>Sim switch</b></td>
 +
        <td>Informs on sim switch changes. Possible triggers are:
 +
            <ul>
 +
                <li><i>Changing to SIM1</i></li>
 +
                <li><i>Changing to SIM2</i></li>
 +
                <li><i>All</i></li>
 +
            </ul>
 +
        </td>
 +
    </tr>|}}|}}
 
     <tr>
 
     <tr>
 
         <td><b>SSH</b></td>
 
         <td><b>SSH</b></td>
Line 144: Line 179:
 
             </ul>
 
             </ul>
 
         </td>
 
         </td>
     </tr>
+
     </tr>{{#ifeq:{{{wifi}}} | 1 |
 +
    <tr>
 +
        <td><b>New WiFi client</b></td>
 +
        <td>Informs on new WiFi clients. Possible triggers are:
 +
            <ul>
 +
                <li><i>Connected</i></li>
 +
                <li><i>Disconnected</i></li>
 +
                <li><i>All</i></li>
 +
            </ul>
 +
        </td>
 +
    </tr>|}}
 
</table>
 
</table>
  
Line 158: Line 203:
 
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 {{#ifeq:{{{dualmodem}}}|1| selected <b>Gateway modem</b>| currently active SIM card}} to the phone number specified in a rule's configuration.
 
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 {{#ifeq:{{{dualmodem}}}|1| selected <b>Gateway modem</b>| currently active SIM card}} to the phone number specified in a rule's configuration.
  
[[File:Networking_rutos_manual_events_reporting_events_reporting_rules_send_sms_dual_modem_{{{dualmodem}}}.png|border|class=tlt-border]]
+
[[File:Networking_rutos_manual_events_reporting_events_reporting_rules_send_sms_dual_modem_{{{dualmodem}}}_v1.png|border|class=tlt-border]]
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
Line 172: Line 217:
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
         <td>Event</td>
+
         <td>Event type</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>Config change {{!}} New DHCP client {{!}} Startup {{!}} Mobile data {{!}} SMS {{!}} Signal Strength {{!}} Reboot {{!}} SSH {{!}} WebUI {{#ifeq:{{{simswitch}}}|1|{{!}} Sim witch|}}{{#ifeq:{{{wifi}}}|1|{{!}} New WiFi client|}}{{#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>
+
         <td>Event that will trigger the rule.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
         <td>Event type</td>
+
         <td>Event subtype</td>
 
         <td>Varies</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>
+
         <td>More specific event type that will trigger the rule.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
         <td>Action</td>
 
         <td>Action</td>
         <td>Send SMS {{!}} Send email; default: <b>Send SMS</b></td>
+
         <td>Send SMS {{!}} Send email; default: <b>Send Email</b></td>
 
         <td>Selects the method of reporting on the specified event.</td>
 
         <td>Selects the method of reporting on the specified event.</td>
 
     </tr>{{#ifeq:{{{dualmodem}}}| 1 |
 
     </tr>{{#ifeq:{{{dualmodem}}}| 1 |
Line 203: Line 248:
 
     <tr>
 
     <tr>
 
         <td>Recipients</td>
 
         <td>Recipients</td>
         <td>Single number {{!}} Group; default: <b>Single number</b></td>
+
         <td>Single {{!}} Group; default: <b>Single</b></td>
 
         <td>Specifies whether the recipient should be a single number or a group of numbers.</td>
 
         <td>Specifies whether the recipient should be a single number or a group of numbers.</td>
 
     </tr>
 
     </tr>
Line 219: Line 264:
 
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.
 
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.
  
[[File:Networking_rutos_manual_events_reporting_events_reporting_rules_send_email.png|border|class=tlt-border]]
+
[[File:Networking_rutos_manual_events_reporting_events_reporting_rules_send_email_dual_modem_{{{dualmodem}}}_v1.png|border|class=tlt-border]]
  
 
<table class="nd-mantable">
 
<table class="nd-mantable">
Line 233: Line 278:
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
         <td>Event</td>
+
         <td>Event type</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>Config change {{!}} Startup {{!}} New DHCP client {{#ifeq:{{{mobile}}}|1|{{!}} Mobile data {{!}} SMS {{!}} Signal Strength {{!}}|{{!}}}} Reboot {{!}} SSH {{!}} WebUI {{#ifeq:{{{eth}}}|1|{{!}} Ports state {{!}} Topology changes |}}{{#ifeq:{{{failover}}}|1|{{!}} WAN Failover |}}{{#ifeq:{{{gps}}}|1|{{!}} GPS|}}{{#ifeq:{{{wifi}}}|1|{{!}} New WiFi client|}}{{#ifeq:{{{simswitch}}}|1|{{!}} Sim switch|}}; default: <b>Config change</b></td>
         <td>The event that you wish to receive notifications on.</td>
+
         <td>Event that will trigger the rule.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
         <td>Event type</td>
+
         <td>Event subtype</td>
 
         <td>Varies</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>
+
         <td>More specific event type that will trigger the rule.</td>
 
     </tr>
 
     </tr>
 
     <tr>
 
     <tr>
 
         <td>Action</td>
 
         <td>Action</td>
         <td>{{#ifeq:{{{mobile}}}|1|Send SMS {{!}} |}}Send email; default: <b>{{#ifeq:{{{mobile}}}|1|Send SMS|Send email}}</b></td>
+
         <td>{{#ifeq:{{{mobile}}}|1|Send SMS {{!}} |}}Send email; default: <b>Send email</b></td>
 
         <td>Selects the method of reporting on the specified event.</td>
 
         <td>Selects the method of reporting on the specified event.</td>
     </tr>
+
     </tr>{{#ifeq:{{{dualmodem}}}|1|
 +
    <tr>
 +
        <td>Modem</td>
 +
        <td>Primary modem {{!}} Secondary modem; default: <b>Primary Modem</b></td>
 +
        <td>Specifies which modem to get information from.</td>
 +
    </tr>|}}
 
     <tr>
 
     <tr>
 
         <td>Subject</td>
 
         <td>Subject</td>

Latest revision as of 14:19, 22 January 2024

The information in this page is updated in accordance with firmware version .


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 Event subtype
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
Reboot Informs after device reboot occurrences. Possible triggers are:
  • From button
  • From Input/Output
  • From Ping Reboot
  • From wget Reboot
  • From Reboot Scheduler
  • From WebUI
  • From SMS
  • All
Startup Informs when device startup completed. Possible triggers are:
  • Device startup completed
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.

[[File:Networking_rutos_manual_events_reporting_events_reporting_rules_send_email_dual_modem_{{{dualmodem}}}_v1.png|border|class=tlt-border]]

Field Value Description
Enable off | on; default: on Turns the rule on or off.
Event type Config change | Startup | New DHCP client | Reboot | SSH | WebUI ; default: Config change Event that will trigger the rule.
Event subtype Varies More specific event type that will trigger the rule.
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]]