NetCloud Manager: Alerting and Reporting
This article describes how to set up alerts, export reports, and export logs from NetCloud Manager (NCM).
NOTE: On July 13, 2017, NetCloud Alerts currently generated from the legacy Enterprise Cloud Manager (ECM) will be updated with the name change to NetCloud Manager (NCM). Automated systems that consume this information may need to be updated accordingly.
Email and API Alert changes include:
- Alert titles will change from “Cradlepoint ECM Alert Notification” to “Cradlepoint NCM Alert Notification”
- Alert subjects will change from "ECM Alert: <friendly info>" to "NCM Alert: <friendly info>"
- Emailed Alert summary report subject will change from "ECM Alert Summary" to "NCM Alert Summary"
- Connection State Alert name will change from “ECM Connection State” to “NCM Connection State”
- Firmware Upgrade alert name will change from “Firmware Upgrade” to “NetCloud OS Upgrade” with an alert description changing to “The router NetCloud OS was successfully upgraded to X.X.X”
Setting Up Alerts
The Alerts page has two views for tracking device status changes:
- The Log view shows a list of alerts sent from the routers to NCM.
- The Settings view shows rules for alerts, including email notifications.
Toggle between these two views by clicking on the buttons at the top left.
Alerts are of the following types:
- Configuration Change
- Configuration Rejected
- Configuration Unacknowledged
- Ethernet WAN Disconnected
- Ethernet WAN Plugged In
- Ethernet WAN Unplugged
- Data Cap Threshold
- Device Location Unknown
- NCM Connection State
- Firmware Upgrade
- Geofence Proximity Change
- Temperature Limit Exceeded
- Modem WAN Connected
- Modem WAN Device Plugged In
- Modem WAN Device Unplugged
- Modem WAN Disconnected
- WAN Service Type
- Account Locked
- Failed Login Attempt
- Intrusion Activity
- IP Address Banned
- IPS Engine Failure
- Successful Login
- Unrecognized Client
- WiFi as WAN Connected
- WiFi as WAN Disconnected
- WiFi as WAN Network Available
- WiFi as WAN Network Unavailable
To enable alerts, including emailed notifications, first select the Settings view and then click on Add at the top left. Create an alert notification rule by completing the fields.
Complete the following fields to create an alert notification rule:
Accounts/Groups (required) – Choose which sets of devices will follow the notification rule. If you select an account, both grouped and ungrouped devices within that account (including all subaccounts) will be assigned to this rule.
Alerts (required) – Select the alert types from the dropdown options.
Users (optional) – If you want emailed notifications for these alerts, select users from the list to receive those emails. If you just want these alerts logged, leave this field blank.
Interval (optional) – Select a time interval from the dropdown options. If you select “Immediately,” an email notification is sent every time one of the selected types of alerts are logged. Otherwise, the alerts are stored over the course of the time interval and then sent together.
Potential NCM Alert Issues
- Receiving the Email Alert seem to take longer than expected.
- Once NCM is aware of the alert, it will verify the alert, and send it out to the configured email address. We do not have control over the alert once we have sent it to its destination address.
- We have seen some mail servers reject, or display abnormally long delays in the alert deliveries.
- To trouble shoot/verify if this is the issue, configure a different email address with a different domain and test the behavior of the alerts.
- Times can also vary depending on the number and type of WAN connections being used for this device.
- If a device only has one internet source, only one connection to NCM, then you can expect delays in the alerts. The alerts are configured in NCM, then NCM lets the router know what to watch for. If the router experiences any issue pertaining to the configured alerts, the router will then report this back to NCM. However the caveat is if the router loses its internet source or connection to NCM, then the router cannot report the issues to NCM until it regains its connection to NCM.
- In cases where you have more than one internet connection the alerts should be fairly on queue, so long as the router can check into NCM via its second internet connection to report its alerts.
Reports allow you to create a summary of information about groups of devices and export that information as a CSV file. Select from several fields to customize your reports. Select the type of report (Data Usage or Signal Quality), a range of dates, the group(s), and identifying fields and then click Run Report to view the report. You also have the option to save the settings of a report for future use.
To export a device’s logs as a CSV file, first enable log reporting for the group the device is in. (This is disabled by default because some users won’t use this functionality – it would unnecessarily use data.) Navigate to the Groups page, select the desired group, and click on Settings.
In the popup window that appears, ensure that Enable Log Reporting is selected.
Once log reporting is enabled, navigate to the Devices page, select the desired device, and click on Export → Export Logs to export the device’s logs as a CSV file.
Published Date: 07/14/2017
This article not have what you need? Not find what you were looking for? Think this article can be improved? Please let us know at firstname.lastname@example.org.