Types of Dashlets

The Dashboard displays three types of dashlets for a selected device:

■Pie-chart dashlets display a ratio of device properties as a pie chart.

■Line-graph dashlets display graphs that show device counts over time.

Tip: Graphs set to intervals longer than one day may not display the data at the last datapoint exactly as shown in the matching field on the Device Info page. This is because data aggregation is occurring less frequently than polling done to update the fields on the Device Info page. Set these graphs to the 6h or 1d intervals to update the data more frequently. Use intervals longer than one day to view data trends.

■Bar charts show percentages of a whole

Customize Dashboard Dashlets

At the upper-right corner of the Devices > Dashboard page, you can:

■Click the Dashboard Settings (cog) button to Add Dashlets and Set Refresh Interval for all active dashlets.

■Click the pencil icon to Add or Remove a Filter for a device.

■Click Refresh icon to refresh the dashlet.

At individual dashlets you can:

■Click the dash (-) icon to minimize the dashlet.

■Click the Refresh icon to refresh the dashlet.

■Click the (+) icon to export data (.csv format) from the dashlet.

■Click the filter icon (pencil icon) to: (Options vary by dashlet type):

–Define reporting intervals by selecting defined periods such as (6h, 1d, 1w, 4w), Last Billing Period and Current Billing Period, or define your own Custom time period.

–Define a Series Selector, which allows you to define different possible states for a chart. For example, the Endpoint Config Group Mismatch Over Time chart has the following Series Selector options: Config Out of Sync and Config in Sync. Clicking the Series Selector option names on the chart can cause the data to display or not display on the chart. When not selected, a name appears in a faded hue on the chart.

–Use drop-down menus found in some table headings to display data in an ascending or descending order or display an additional heading option (such as Down Routers Over Time) in the table.

–Define the number of entries that display on the chart by selecting a value from the Show drop-down menu.

–Display data as either a bar chart or pie chart.

–Define a custom line-graph chart. Select the number of devices to chart for line-graph chart displays.

–Select a series to refine data in line-graph chart displays.

–Filter line-graph chart displays by group.

–Add a Filter

■Click (X) to close the dashlet.

Pre-defined Dashlets

The IoT FND Dashboard dashlets are described in the table below.

Repositioning Dashlets

You can configure the Dashboard to display charts in your preferred arrangement.

■Click and drag the title bar of a chart to the desired position.

■Click (x) within a chart to remove the chart from the page.

■Collapse a dashlet to display only its title bar (such as Endpoint Inventory) by clicking the Minimize button (-).

■To refresh a dashlet, click its Refresh button ( ).

Setting the Dashlet Refresh Interval

To set the refresh interval for dashlets:

1. Choose DEVICES > Dashboard.

2. Click the Dashboard Settings button ( ).

3. Click Set Refresh Interval.

4. From the drop-down menu, choose a refresh interval.

5. Close the Dashboard Settings dialog box when finished.

Adding Dashlets

To add dashlets to the Dashboard:

1. Choose DEVICES > Dashboard.

2. Click the Settings button in the upper-right hand corner of the page ( ).

3. Click Add Dashlets (+).

Note: No dashlets display in this dialog box if all are displaying on the Dashboard.

4. To add a listed dashlet to the Dashboard, select the name of dashlet.

5. Close the Dashboard Settings dialog box by clicking (x) in upper-right corner of panel when finished.

Removing Dashlets

To remove dashlets from the Dashboard:

1. Choose DEVICES > Dashboard.

2. Close the dashlet by clicking (x) in the upper-right corner of the panel.

Using Pie Charts to Get More Information

Roll over any segment of a pie chart to display a callout with information on that segment.

Click the Router Inventory and Mesh Endpoint Inventory pie charts to display the devices in List View.

Setting Dashlet Time Properties

To specify the time interval for data collection for line-graph dashlets, click the interval icon ( ) in the title bar to display the 6h, 1d, 1w, 4w, or Custom buttons on the dashlet. The 6h button sets the data-collection time interval to the last six hours. The 1d button sets the time interval to the last 24 hours.

1. Click Custom.

2. In the window that appears, select the time frame using the From and To fields. Click OK.

Collapsing Dashlets

Click the minimize icon (-) at the upper-right of the dashlet window to hide the window.

Using the Series Selector

You use the Series Selector to refine line-graphs to display by device status. The device options are:

■Routers: Down, Outage, Unsupported, Unheard, and Up

■Mesh Endpoint Config Group: Config Out of Sync and Config In Sync

■Mesh Endpoint Firmware Group: Membership Out of Sync and Membership In Sync

■Mesh Endpoint States: Down, Outage, Unheard, and Up

To use the Series Selector:

1. Click Series Selector.

2. In the Series Selector dialog box, check the check boxes for the data series to show in the graph.

3. Click Close.

Using Filters

You use filters to refine the displayed line-graph data by groups. Applied filters display after the dashlet title.

To use the filters:

1. Click the interval icon (pencil) in the upper-right corner of the panel to display the 2 filtering parameters on the chart: a time frame (such as 6h) and components (such as Endpoint Configuration Groups, Mesh Endpoints (MEs).

2. Click a time frame.

3. From the first drop-down menu, choose a group type.

4. From the third drop-down menu, choose a group.

5. Click Apply.

The pencil icon is green and the filter displays next to the dashlet name to indicate that a filter is applied.

Note: Click the Remove Filter button to remove the filter and close the filter options.

Exporting Dashlet Data

You can export dashlet data to a CSV file.

To export dashlet data:

1. On the desired dashlet, click the export button (+).

A browser download session begins.

2. Navigate to your default download directory to view the export file.

The filename begins with the word “export-” and includes the dashlet name (for example, export-Node_State_Over_Time_chart-1392746225010.csv).

Viewing Events

As shown in Operation > Events Page, the Events page (OPERATIONS > Events) lists all events for those devices that IoT FND tracks. All events are stored in the IoT FND database server.

Figure 2 Operation > Events Page

By default, the Operations > Events page displays the Events chart, which is a visual view of events in a time line. However, depending on the number of devices the IoT FND server manages, this page can sometimes time out, especially when the system is fully loaded. In that case, open the Preferences window by choosing username > Preferences (top right), clearing the check boxes for showing chart and summary counts on the Events page, and clicking Apply.

■To limit the amount of event data displayed on this page, use the Filter drop-down menu (at the top of the left pane). For example, you can show the events for the last 24 hours relative to the last 30 days, or events for a specific day within the last seven days.

■To enable automatic refresh of event data to refresh every 14 seconds, check the check box next to the Refresh button. To immediately refresh event data click the Refresh button or the refresh icon.

Note: The amount of event data displayed on the Events page is limited by the data retention setting for events at ADMIN > System Management > Data Retention.

All Events Pane Filters

Use the preset filters in the All Events pane to only view those event types.

Device Events

In the left pane, IoT FND tracks events for the following devices:

■Routers

■Endpoints

■Head-end Devices

■CG Mesh Devices

■NMS Servers

■Database Servers

Event Severity Level

In the left pane, select an event severity level to filter the list view to devices with that severity level:

■Critical

■Major

■Minor

■Info

Each event type has a preset severity level. For example, a Router Down event is a Major severity level event.

Preset Events By Device

IoT FND has a preset list of events it reports for each device it tracks. A list of those events is summarized under each device in the left pane on the Events page. For example, in the left pane click the show/hide icon ( ) next to Routers to expand the list of all events for routers.

Filtering by Severity Level

To filter by severity level, click the pencil icon:

1. Choose OPERATIONS > Events.

2. Click the SEVERITY show/hide arrow (left-pane).

Note: Only those severity levels (CRITICAL, MAJOR, MINOR, OR INFO) that have occurred display in the left pane under the SEVERITY heading.

3. Click a severity level to display all events of that severity level in the Events pane (right-pane).

Advanced Event Search

To use the filter to search for events:

1. Choose OPERATIONS > Events.

2. Under All Events (left pane), select an event category to narrow down your search.

3. Click the Show Filter link at the top of the main pane.

4. Use the filter drop-down menus and fields to specify your search criteria.

5. Click the plus button (+) to add the search strings to the Search field.

Repeat the process of adding search strings to the Search field as needed.

6. Click Search Events or press Enter.

The search results display in the Events pane.

You can also add search strings manually, as shown in the following examples:

■To filter events by Name (EID), enter the following string in the Search Events field, as shown in Search Events by Name Filter:

name: router eid string.

Search Events by Name Filter

Note: Note the use of the asterisk (*) wild card with this filter.

■To filter by event time period, enter the following string in the Search Events field, as shown in graph below:

eventTime operator“YYYY-MM-DD HH:MM:SS:SSS”

Supported operators are: <, >, >=, <=, :

Note: Do not enter a space between eventTime and the operator.

Sorting Events

To sort events in ascending or descending order, roll over any column and select the appropriate option from the heading drop-down menu.

Searching By Event Name

To search by event name (for example, Battery Low):

1. Choose OPERATIONS > Events.

2. In the left pane, click the device type.

3. Click the Show Filter link at the top of the right pane to display the search fields.

4. Choose Event Name from the left drop-down menu.

5. Choose the event name from the options in the right drop-down menu.

6. Click the plus button (+) at the right to add the filter to the Search Events field.

The filter syntax appears in the Search Events field.

7. Click the Search Events button (magnifying glass icon).

The search results display in the Events pane.

Searching by Labels

Allows you to search and filter events based on Label names tagged to Field Devices.

1. Choose OPERATIONS > Events.

2. Click All Events in the left pane.

3. Click the Show Filter link at the top of the right pane.

4. Choose Label from the left drop-down menu.

5. Choose the event name from the options in the right drop-down menu or create your own.

6. Click the plus button (+) at the right to add the filter to the Search Events field.

The filter syntax appears in the Search Events field.

7. Click the Search Events button (magnifying glass icon).

The search results display in the Events pane.

Exporting Events

You can export events to a CSV file to examine as a log of event severity, time, name and event description by device.

To export events:

1. Choose OPERATIONS > Events.

2. Click the desired severity level or device type in the left pane.

3. Click the Export button (+).

A browser download session begins.

4. Navigate to your default download directory to access the CSV file.

Events Reported

Events Reported lists the events reported by IoT FND 3.1.x (and later). Details include the event severity (Critical, Major, Minor, Information) and the devices that report those events.

Viewing Issues

IoT FND offers different ways to monitor issues:

■The OPERATIONS > Issues page (OPERATIONS > Issues Page) provides a snapshot of the health of the network by highlighting only major and critical events that are active within the network.

■The Issues Status bar (Issues Status Bar) displays in the footer of the browser window and shows a count of all issues by severity for selected devices.

Figure 3 OPERATIONS > Issues Page

The Issues page provides an abbreviated subset of unresolved network events for quick review and resolution by the administrator. Issues remain open until either the associated event is resolved (and IoT FND generates a resolution event) or the administrator manually closes the event.

Only one issue is recorded when multiple entries for the same event are reported. Each issue has a counter associated with it. As an associated event is closed, the counter decrements by one. Every open or closed issue has an associated event.

Note: The amount of closed issues data that displays on the Issues page is limited by the Keep Closed Issues for data retention setting (ADMIN > System Management > Data Retention), which is based on the time the issue was closed. When the issue was closed displays as the Last Update Time for the issue.

Viewing Device Severity Status on the Issues Status Bar

A tally of issues listed by severity for the selected devices displays in the Issues status bar in the bottom-right of the browser window frame (Issues Status Bar). You can set the device types for issues that display in the Issues status bar in User Preferences.

Figure 4 Issues Status Bar

Click the Issues status bar to view the Issues Summary pane (Issues Summary Pane), which displays issues listed by the selected device category. Click count links in the Issues Summary pane to view complete issue criteria filtered by severity on the OPERATIONS > Issues page.

Figure 5 Issues Summary Pane

Adding Notes to Issues

On the OPERATIONS > Issues page, you can add notes about Issues for a device.

Click the Notes link inline to access any notes entered for the Issue or add a note on the Notes for Issues Name page.

You can edit and delete notes from issues on this page. Issues can have multiple notes. Notes on the Issues Name page display the time the note was created, the name of the user who wrote the note, and the text of the note. You can also add a note when closing an Issue. Notes are purged from the database with the issue.

Note: In some cases, existing notes may exist for the system and the Notes for Issues Name pane displays.

To add a note to an Issue:

1. Click the Notes link inline or check the check box of the device and click Add Note.

The Notes for Issues Name pane displays.

2. Click Add Note.

The Add Note dialog displays.

3. Insert your cursor in the Note field and type your note.

4. Click Add when finished.

To edit an existing note in an issue:

1. Click the Notes link inline with the issue.

The Notes for Issues Name pane displays.

2. Click the pencil icon () at the right of the note that you want to edit.

3. Edit the note, and click Done when finished.

To delete a note from an issue:

1. Click the Notes link inline with the issue.

The Notes for Issues Name pane displays.

2. Click the red (X) icon at the right of the note.

3. Click Yes to confirm the deletion.

To add a note when closing an issue:

1. At the Operations > Issues page, check the box next to the issue you are closing.

2. Click Close Issue button that appears above the event listings.

3. In the Confirm dialog box, insert your cursor in the Note field and type the note text.

4. To confirm that you want to close the issue and save the note, click Yes.

Searching Issues Using Predefined Filters

To search for open issues for a specific system or severity level:

1. Choose OPERATIONS > Issues.

To list only open issues, click All Open Issues (left pane).

Note: By default, IoT FND displays all issues that occurred within the specified data retention period (see Configuring Data Retention):

–To see Closed Issues associated with an event type or severity level, change issueStatus:OPEN to issueStatus:CLOSED in the Search Issues field, and then click Search Issues.

–To list all closed issues, in the left pane, click All Closed Issues.

2. Click a device category, event type, or severity level to filter the list.

The filter syntax appears in the Search Issues field, and the search results display in the main pane.

Search Issues Using Custom Filters

To search by creating custom filters:

1. Choose OPERATIONS > Issues.

2. Click Show Filter.

3. From the Filter drop-down menus, choose the appropriate options.

For example, to filter Severity levels by Name (EID):

You can also enter the search string in the Search Issues field. For example:

issueSeverity:MAJOR issueStatus:OPEN name:IR807G-LTE-GA-K9+FCW21320020

4. Click Search Issues.

The issues, if any, display in the Search Issues section (right pane).

5. Click the Events link to display events associated with an issue.

The Events for Issue Name pane displays all events for that device.

6. Click Search Issues or any link in the left pane to return to the Issues pane.

Closing an Issue

In most cases, when an event is resolved, the issue is closed automatically by the software. However, when the administrator has actively worked on resolving the issue, it might make sense to close the issue directly. When the issue is closed, IoT FND generates an event.

To close a resolved issue:

1. Choose OPERATIONS > Issues.

2. Locate the issue by following the steps in either the Searching Issues Using Predefined Filters or Search Issues Using Custom Filters section.

3. In the Search Issues section (right pane), check the check boxes of the issues to close.

4. Click Close Issue.

Note: You can also add a note to the issue at this time.

5. Click Yes.

Router Charts

IoT FND provides these charts in the Device Info pane on the Device Details page for any router:

Router Device Page shows the Router Device Info page.

Figure 6 Router Device Page

Mesh Endpoint Charts

IoT FND provides the charts listed in Device Detail Charts in the Device Info pane on the Device Details page for any mesh endpoint.

Figure 7 Mesh Endpoint Device Info Page (partial view)