Collect Analytics Data Overview
Paragon Automation supports collecting analytics data from Juniper Networks, Nokia, and Cisco IOS XR devices.
- Table 1 lists the data collected from Juniper Networks devices.
- Table 2 lists the data collected from Cisco IOS XR devices.
- Table 3 lists the data collected for Nokia devices.
Data |
Collected by Default |
Ingest Type |
Rules Used to Collect Data |
---|---|---|---|
Label-switched Path (LSP) statistics [RSVP, Segment Routing (both colored and non-colored)]* Note:
Currently, Paragon Pathfinder does not support the collection of SRv6 LSP statistics. |
Yes |
JTI |
controller-telemetry /ctrl-label-switched-path controller-telemetry /ctrl-label-switched-path-aggregation |
Logical and physical interface statistics |
Yes |
JTI |
controller-telemetry /ctrl-logical-interface controller-telemetry /ctrl-logical-interface-aggregation controller-telemetry /ctrl-physical-interface controller-telemetry /ctrl-physical-interface-aggregation |
Segment ID (SID) |
Yes |
JTI |
controller-telemetry /ctrl-sr-sid |
Link Latency |
Yes |
iAgent |
controller-telemetry /ctrl-link-latency |
LSP Latency |
Yes |
Derived from Syslog |
controller-telemetry /ctrl-lsp-latency |
Quality of Service (QoS) |
No |
JTI |
controller-telemetry /ctrl-egress-queue-interface controller-telemetry /ctrl-ingress-queue-interface |
Label Distribution Protocols (LDP) demands |
No |
iAgent |
controller-telemetry /ctrl-ldp-demand-stats |
Netflow | Yes | Not Applicable | controller.telemetry/ctrl-demand-stats controller.telemetry/ctrl-as-demand-stats |
Note:
Note:
For Juniper devices, the Path Computation Element Protocol (PCEP) reports the route metric. For more information, see Basic LSP Configuration. You can set the route metric for an LSP and configure the global preference of Paragon Pathfinder from the Configuration > Network Settings > Pathfinder Settings > Path Computation Server page. |
Data |
Collected by Default |
Ingest Type |
Rules Used to Collect Data |
---|---|---|---|
Label-switched Path (LSP) statistics [RSVP, segment routing] |
Yes |
SNMP The Management Information Base (MIB) used is MPLS-TE-STD-MIB::mplsTunnelTable). |
controller-telemetry /ctrl-label-switched-path-snmp-aggregation |
Label-switched Path (LSP) statistics [segment routing, color] |
No |
SNMP The Management Information Base (MIB) used is IF-MIB::ifXTable. |
controller-telemetry /ctrl-label-switched-path-sr-color-snmp-cisco-aggregation |
Logical and physical interface statistics |
Yes |
|
|
Netflow | Yes | Not Applicable | controller.telemetry/ctrl-demand-stats controller.telemetry/ctrl-as-demand-stats |
Cisco devices do not send color attribute over PCEP. You have to manually configure the color attribute for SR colored LSPs or run the device collection on the device.
Sample configuration:
API - https://{{UI-IP}}/traffic-engineering/api/topology/v2/1/te-lsps/{{LSP-INDEX}} Operation - PATCH Body - [{"op":"replace","path":"/plannedProperties/color","value":<color>}]
For Cisco IOS XR devices, the reported metric is the sum of the IGP metrics on all outgoing interfaces along a particular path from the source to the destination.
Data |
Collected by Default |
Ingest Type |
Rules Used to Collect Data |
---|---|---|---|
Label-switched Path (LSP) statistics [RSVP, segment routing] |
Yes |
SNMP The Management Information Base (MIB) used is MPLS-TE-STD-MIB::mplsTunnelTable). |
controller-telemetry /ctrl-label-switched-path-snmp-nokia-aggregation |
Logical and physical interface statistics |
Yes |
SNMP The Management Information Base (MIB) used is IF-MIB::ifXTable. |
SNMP: controller-telemetry /ctrl-logical-interface-snmp-aggregation controller-telemetry /ctrl-physical-interface-snmp-aggregation |
The default SNMP collection interval is 300 seconds. You can modify the interval from the ctrl-snmp-frequency field in the Frequency profile tab on the Ingest Settings page (Configuration > Data Ingest > Settings). See Manage Frequency Profiles for details.
For Nokia devices, the reported metric is the sum of the IGP metrics on all outgoing interfaces along a particular path from the source to the destination.
Workflow to Collect Device Statistics
Paragon Automation contains a default controller device group and a default controller playbook. Devices must be added to the controller device group so that analytics data can be collected from these devices. The controller playbook defines the rules for collecting the analytics data.
The following is the workflow to collect analytics data in Paragon Automation:
-
If not added already, add the devices from which you want to collect data, to the Controller device group. See Edit a Device Group.
-
Run the device collection task to correlate the links to the interfaces displayed in the topology view (Network > topology); see Add a Device Collection Task.
-
For a Juniper Networks device, configure the devices to send JTI telemetry data and RPM statistics; see Configure Routers to Send JTI Telemetry Data and RPM Statistics to the Data Collector.
-
For a Cisco IOS XR device, configure OpenConfig or SNMP for collecting interface statistics:
-
Access the CLI of the Cisco IOS XR device.
-
Do one of the following:
-
To configure OpenConfig on Cisco IOS XR devices, add the following configuration:
grpc port 32767 no-tls ! telemetry model-driven sensor-group JTIMON_INTERFACE sensor-path openconfig-interfaces:interfaces ! subscription hbot_interfaces_ sensor-group-id JTIMON_INTERFACE sample-interval 10000 ! subscription hbot_interfaces_interface_state_ sensor-group-id JTIMON_INTERFACE sample-interval 10000 ! subscription hbot_interfaces_interface_subinterfaces_subinterface_state_ sensor-group-id JTIMON_INTERFACE sample-interval 10000 ! !
- To configure SNMPv2 on Cisco IOS XR devices, add the following
configuration:
snmp-server community public RO
- To configure SNMPv3 on Cisco IOS XR devices, add the following configuration:Note:
The following is a sample configuration.
snmp-server view ViewDefault iso included snmp-server group GrpMonitoring v3 priv read ViewDefault snmp-server user UserJustMe GrpMonitoring v3 auth sha AuthPass1 priv aes 128 PrivPass2
After you add the SNMPv3 configuration, configure the SNMPv3 parameters from the Devices page (Configuration > Devices). See Configure SNMP Ingest for details.
-
-
Commit the configuration.
commit
-
-
Add optional rules to the controller playbook in Paragon Automation.
The rules for collecting LSP statistics, interface statistics, SID statistics, and link latency are added to the controller playbook by default.
If you want to collect QoS and LDP demand statistics, you must add the rules for collecting these statistics manually. To add rules to the controller playbook.
-
Click the Configuration > Playbooks icon in the left navigation menu.
The Playbooks page appears.
-
Click the Controller playbook.
The Edit Playbook Controller page appears.
-
In the Rules field, click and select the following rules:
-
controller-telemetry/ctrl-egress-queue-interface and controller-telemetry/ctrl-ingress-queue-interface for collecting QoS data.
-
controller-telemetry/ctrl-ldp-demand-stats for collecting LDP demand statistics.
-
-
Click Save and Deploy.
A confirmation message appears that the playbook is successfully saved and deployed on the devices in the controller device group.
For more details on editing a playbook, see Edit a Playbook
-
Pause the current playbook instance assigned to the controller device group and add the new playbook instance. see Manage Playbook Instances for details.
-
(Optional) Delete the paused playbook instance.
-
-
Commit the configuration.
commit
-
Add the following data rollup summarization profiles to the controller device group, if you added rules for QoS data in step 5:
ctrl-egress-queue-interface-rollup-profile and ctrl-ingress-queue-interface-rollup-profile
controller-default-rollup-profile is added to the controller device group by default.
For details about data summarization profiles, see Data Summarization Overview and Apply Data Summarization Profiles.
-
Add devices to the collector device group to enable collecting the device data.
Do one of the following to add a device to a device group:
-
Edit the controller device group to add more devices; see Edit a Device Group
-
Assign the device to the controller device group; see Edit Devices
Note:The Junos telemetry interface (JTI) sensors use the system ID parameter of Juniper Networks devices to collect data from the devices. So, if not already configured in Paragon Automation, configure the system ID for the Juniper Networks devices. The system ID should be in the following format: <host_name>:<jti_ip_address> and should have the same value as configured on the device; see Edit Devices for configuring the system ID of a device in Paragon Automation.
-
Sample Configuration for collecting Telemetry from Cisco IOS XR Devices
The subscription name on a Cisco device must be derived from the
sensor-name of the Paragon Insights rule. The subscription
depends on the sensor-name you want to execute on the Cisco
device. For example, if the sensor-name is
/interfaces-test
, the subscription name needs to be configured
in IOS-XR as hbot_interfaces_test_
.
When Paragon Automation sends the subscription request to the Cisco device:
-
A prefix
hbot_
is added to the sensor-name, and -
all the non-letter and non-digit characters are replaced with an underscore (_).
The conversion will take place only if the sensor-name is configured with a leading slash (/).
The following is sample configuration of the Paragon Insights rule for obtaining telemetry from Cisco IOS XR devices:
set healthbot topic controller.telemetry rule ctrl-label-switched-path sensor sr-lsp-mdt open-config sensor-name /jtimon_sr_te set healthbot topic controller.telemetry rule ctrl-label-switched-path sensor sr-lsp-mdt open-config frequency 60s set healthbot topic controller.telemetry rule ctrl-label-switched-path field lsp-stats-bytes sensor sr-lsp-mdt path /xtc/policy-forwardings/policy-forwarding/stats/bytes set healthbot topic controller.telemetry rule ctrl-label-switched-path field lsp-stats-counter sensor sr-lsp-mdt path "/xtc/policy-forwardings/policy-forwarding/@name" set healthbot topic controller.telemetry rule ctrl-label-switched-path field lsp-stats-packets sensor sr-lsp-mdt path /xtc/policy-forwardings/policy-forwarding/stats/packets set healthbot topic controller.telemetry rule ctrl-label-switched-path field to-ip sensor sr-lsp-mdt path /xtc/policy-forwardings/policy-forwarding/active-lsp/candidate-path/name
Since the sensor-name is /jtimon_sr_te
, the Cisco
IOS configuration will be:
subscription hbot_jtimon_sr_te_ sensor-group-id sr-te sample-interval 10000 !
Data Summarization and Retention Policy
Paragon Automation uses summarization (rollup) profiles to rollup data so that the data is stored in a smaller disk space and performance of the time-series database (TSDB) is improved. Raw network and device data are grouped together into hourly and daily data by using aggregate functions. For more information on data summarization, see Data Summarization Overview.
By default, the data is retained for the following duration:
-
Daily rollup data is stored for 1000 days.
-
Hourly rollup data is stored for 180 days.
-
Raw data is stored for 14 days.
You can modify the default duration for which the rollup data is retained from the Ingest Settings page Administration > Ingest Settings > Retention Policy.
The network archive task uses the rolled-up data for providing network statistics.
Also, statistics are displayed on the topology graphs by fetching long range data
from rolled-up measurements based on the
rollup-query-cutoff-interval
Paragon Pathfinder setting.
rollup-query-cutoff-interval
defines the time period for which raw
data or rolled-up data is fetched. If data is queried for a time period less than or
equal to the value set in rollup-query-cutoff-interval
, raw data is
fetched, If data is queried for a time greater than
rollup-query-cutoff-interval
, hourly rolled-up data is fetched.
The default value is set to 7 days; that is, by default, rolled-up data is fetched
when queried for data greater than 7 days. For information about setting the
rollup-query-cutoff-interval
parameter, see Modify Pathfinder Settings From the GUI or Modify Pathfinder Settings From the Pathfinder CLI.