Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 

Scheduling Device Collection for Analytics

 

The NorthStar Controller Analytics features require that the Controller periodically connect to the network in order to obtain the configuration of network devices. It uses this information to correlate IP addresses, interfaces, and devices.

Completion of device profiles (Administration > Device Profile) is a prerequisite for successfully running device collection tasks.

To schedule a new device collection task, navigate to Administration > Task Scheduler.

  1. Click Add in the upper right corner. The Create New Task window is displayed as shown in Figure 1.
    Figure 1: Create New Task Window
    Create New Task Window
  2. Enter a name for the task and use the drop-down menu to select the task type Device Collection. Click Next to display the first Create New Task – Device Collection window as shown in Figure 2.
    Figure 2: Device Collection Task, All Devices
    Device Collection Task, All
Devices

    On the Task Options tab, you can choose All devices, Selective devices, or Groups as a method for specifying the devices to be included in the collection task. For all three of those choices, the following fields are available:

    • Use management IP (the default is yes).

    • Parse collection (the default is yes).

      Parsing reads the content of the files and updates the network model accordingly. If parsing is not selected, the configuration files are collected on the server, but not used in the model.

    • Archive raw data (the default is yes). Raw data is archived in Elasticsearch.

    If you select “Selective devices”, you are presented with a list of all the devices available to be included in the collection task. Figure 3 shows an example.

    Figure 3: Device Collection Task, Selective Devices
    Device Collection Task,
Selective Devices

    Click the check boxes corresponding to the devices you want to include.

    If you opt for Groups, you are presented with a list of the device groups that have been configured in Administration > Device Profile, as shown in Figure 4.

    Figure 4: Device Collection Task, Groups
    Device Collection Task, Groups

    Click the check boxes corresponding to the groups you want to include.

    Click Next to continue.

    On the Collection Options tab, you can select the types of data to be collected or processed as shown in Figure 5.

    Figure 5: Device Collection Task, Collection Options
    Device Collection Task,
Collection Options

    Click the appropriate check boxes to select or deselect options. You can also Select All or Deselect All. By default, the first four options listed are collected.

    Note

    We recommend that you collect router configuration, tunnel path and tunnel transit show commands when running the device collection task so that NorthStar can update the tunnel status and details based on the latest collection.

    Equipment CLI data is collected in device collection tasks that include the Equipment CLI option. The Process Equipment CLI option in Network Archive collection parses the Equipment CLI data collected in device collection and generates the Inventory Report available in both the NorthStar Controller and the NorthStar Planner.

    To view Hardware Inventory in the NorthStar Planner, you must run device collection with the Equipment CLI collection option (collects the inventory data) and you must run Network Archive collection with the Process Equipment CLI option (processes the inventory data).

    Each of the options results in the collection task capturing the results of various show commands. Table 1 lists the show command output captured for each option.

    Table 1: Show Command Output Captured by Device Collection Options

    Data Type

    For Juniper Devices

    For IOS-XR Devices

    Configuration

    show configuration | display inheritance brief | no-more

    show running

    Interface

    show configuration system host-name | display inheritance brief

    show interfaces | no-more

    show running | include hostname

    show interfaces

    show ipv4 interface

    Tunnel Path

    show configuration system host-name | display inheritance brief

    show mpls lsp statistics ingress extensive logical-router all | no-more

    show running | include hostname

    show mpls traffic-eng tunnels detail role head

    Transit Tunnel

    show configuration system host-name | display inheritance brief

    show rsvp session ingress detail logical-router all | no-more

    show rsvp session transit detail logical-router all | no-more

    show running | include hostname

    show mpls traffic-eng tunnels backup

    Switch CLI

    show configuration system host-name | display inheritance brief

    show l ldp neighbor | no-more

    show virtual-chassis status | no-more

    show running | include hostname

    show cdp neighbor detail

    Equipment CLI

    show configuration system host-name | display inheritance brief

    show version | no-more

    show chassis hardware | no-more

    show chassis fpc | no-more

    show chassis hardware models | no-more

    show version

    show diag

    show env all admin

    show inventory

    show inventory raw

  3. Click Next to proceed to the scheduling parameters. The Create New Task - Schedule window is displayed as shown in Figure 6. You can opt to run the collection only once, or to repeat it at configurable intervals. The default interval is 15 minutes.
    Figure 6: Device Collection Task, Scheduling
    Device Collection Task,
Scheduling

    Instead of scheduling recurrence, you can select to chain the task after an already-scheduled recurring task, so it launches as soon as the other task completes. When you select the “Chain after another task” radio button, a drop-down list of recurring tasks is displayed from which to select.

  4. Click Submit to complete the addition of the new collection task and add it to the Task List. Click a completed task in the list to display the results in the lower portion of the window. There are three tabs in the results window: Summary, Status, and History. Figure 7 shows an example of the Summary tab. Figure 8shows an example of the Status tab.
    Figure 7: Device Collection Results, Summary Tab
    Device Collection
Results, Summary Tab
    Figure 8: Device Collection Results, Status Tab
    Device Collection
Results, Status Tab

The device collection data is sent to the PCS server for routing and is reflected in the Topology view. See Viewing Analytics Data in the Web UI for more information.