Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

About the Tunnels Tab (Network Optimization)

To access the Tunnels tab, click Network Optimization > Network > Network Optimization Intent.

On the Tunnels tab, you can view the information about all label-switched paths (LSPs) or segment routing policies, also known as tunnels, in your network. Routing Director uses Path Computation Element Protocol (PCEP) sessions to discover the tunnels that run in your network.

Note: For Routing Director to discover tunnels in your network:

  1. A PCEP session must be established between Routing Director and the devices.

    To establish a PCEP session, you must specify a VIP address either at the time of installing Routing Director or post-installation of the cluster. For more information, see Configure a PCE Server.

    To establish PCEP on a router, see Configuring PCEP on a PE Router.

    To configure BGP-LS topology acquisition on Routing Director, see Configuring Topology Acquisition Using BGP-LS.

  2. You must have adopted or onboarded the device using Routing Director; otherwise, the tunnel-related information is not displayed on the Tunnels tab.

Table 1 provides information on the fields in the Tunnels tab.

To perform common actions such as filtering using advanced filter criteria and resetting preferences, see Network Table Overview.

Tasks You Can Perform

Note:

You cannot provision a tunnel from the Tunnels tab of the Network Optimization Intent page (Network Optimization > Network). You must provision the tunnel from the Tunnels tab of the Topology page (Observability > Network). For more information see, Add a Tunnel.

  • Hide unrelated nodes of a tunnel—To hide unrelated nodes of a tunnel, select one or more tunnels and enable the Hide unrelated toggle button. The topology map limits the display to only the nodes that are related to the selected tunnel.

  • Provision a tunnel—Click Provisioning and select Tunnel to provision a tunnel. For more information, see Add a Tunnel.

    Note:

    Only Path Computation Element Protocol (PCEP) provision method is supported.

  • View events for tunnels—To view historical events (such as actions performed on the tunnel and bandwidth changes) for a tunnel for a specific time range, select the tunnel and click View > Event History.

    On the Events page, you can:

    • View a graphical representation of bandwidth changes and traffic through an LSP to analyze trends over time. The bandwidth changes represent the changes in the signaled bandwidth.

      Select the period for which you want to view the bandwidth-related data. You can view data for the previous 2 hours, 4 hours, 8 hours, 16 hours, 24 hours, 1 week, or choose from a custom time range by specifying the start and end dates and the time.

    • View changes to label-switched path (LSP) attributes and events in the table. The Timestamp column helps you to identify the time at which a change has been made to a tunnel.

    • View changes to label-switched path (LSP) on the Topology map. You can use the More > Show Path Changes option to view highlights on the Topology map for any changes to the LSP path, making it easier to track and analyze routing changes.

    • Download comma-separated values (CSV) file that includes information on LSP event history to your local system by clicking the More > Show Path Changes option.

  • Download—To download tunnels-related data to your local system, click Download. The data is downloaded to your local system as a comma-separated values (CSV) file.

  • From the More list, you can perform the following tasks:

    • View details of a tunnel—To view the details of a tunnel, you can do one of the following:

      • Select a tunnel on the table and click More > Show Details. The Tunnel - Tunnel-Name page appears. You can view the To and From traffic-related information.

      • Hover over a tunnel row in the table and click the Details icon. The Tunnel - Tunnel-Name page appears. You can view the To and From traffic-related information.

    • Reload—To view the latest changes in the network map, click Reload.

  • To perform common actions such as filtering using advanced filter criteria and resetting preferences, see Network Table Overview.

Table 1: Fields on the Tunnel Table
Fields Description

Name

Displays the name of the tunnel.

Device A

 Displays the device at which traffic enters.

Device Z

 Displays the device at which traffic exits.

IP A

 Displays the IPv4 address of the interface from which device A sends traffic.

Routing Director displays the IPv4 address of IP A based on device A's active configuration. If the IPv4 addresses of IP A and IP Z are in the same subnet, Routing Director forms an interface between devices A and Z.

IP Z

 Displays the IPv4 address of device Z interface that receives traffic.

Routing Director displays the IPv4 address of IP Z based on device Z's active configuration. If the IPv4 addresses of IP A and IP Z are in the same subnet, Routing Director forms an interface between devices A and Z.

Vendor

Displays the vendor name of the device.

Bandwidth

Displays the traffic rate associated with the LSPs, fast reroutes, or multiclass LSPs.

Color

Displays the color associated with the segment routing (SR) policy.

A segment routing (SR) policy uses the color community value to steer traffic flows on to a tunnel.
Planned Color

Displays the planned color value for the SR policy.

Admin Group Include All

Displays a list of all admin groups that are created for LSPs.

Admin groups are created to implement a variety of policy-based LSP setups.

Admin Group Include Any

Displays a list of the admin groups that are created for LSPs.

Admin groups are created to implement a variety of policy-based LSP setups.

Metric

Displays the metric value of an LSP.

The LSP metric is used to indicate the ease or difficulty of sending traffic over a particular LSP. Lower LSP metric values (lower cost) increase the likelihood of an LSP being used. Conversely, high LSP metric values (higher cost) decrease the likelihood of an LSP being used.
Control Type

Displays the control type.

Path Type

Displays the type of LSP path—primary, secondary, or standby.

Path Name

Displays the user-defined name of the LSP path.

Type

Displays the type of the LSP—RSVP or SR.

Op Status

Displays the operational status of the LSP—Failed, pending, unknown, active.

Setup

Displays the setup priority of the LSP. The setup priority ranges from 0 (highest) through 7 (lowest).

Hold

Displays the RSVP hold priority for the tunnel traffic. The hold priority ranges from 0 (highest) through 7 (lowest).
Flex Algo ID Displays the flex algo ID that is associated with the LSP.

Record Route

Displays whether an LSP should actively record the path by sending the record route object (RRO). The RRO is used to record the path that the LSP traverses. It includes the IP address and router/node ID of each RSVP node in the path.

Calculated Route

Displays the path computed for the tunnel.

Last Update

Displays the last updated time of the LSP.

Controller Status

Displays the controller status—No path found, Reschedule in X minutes.

RRO Hop Count

Displays the hop count of the record route object (RRO). The RRO keeps track of the actual path the LSP is traversing.

Comment

Displays the comment that the user has added at the time of tunnel creation.

Admin Group Exclude

Displays the admin group that is excluded.

The tunnel traverses links that do not include any of the admin groups listed here.

Planned Metrics

Displays the static tunnel metric.

The PCE uses this metric to route the tunnel instead of allowing the router to choose a path

Signaling address

Displays the signaling address Egress Peer Engineering (EPE).

Path Intent

Displays the name of the path intent, if any.

Control Type

Displays the control type.
Diversity Group Displays the name of the diversity group to which this tunnel belongs
Diversity Level Displays the diversity level (Link, SRLG, or site) of the tunnel.
Maximum Delay

Displays the maximum delay specified for the tunnel.

The maximum delay is displayed in milliseconds.
Planned Bandwidth

Displays the planned bandwidth specified for the tunnel.
Bandwidth Sizing

Displays whether the bandwidth sizing is enabled or disabled for the tunnel.

If you have enabled bandwidth sizing, the tunnel is included in the periodic re-computation of planned bandwidth based on aggregated tunnel traffic statistics.
Adjustment Threshold

Displays the sensitivity (in percentage) of the automatic bandwidth adjustment. The new planned bandwidth is considered only if the percentage difference is greater than or equal to the threshold value. It is the minimum percentage change in the measured traffic that is required to trigger an automatic bandwidth adjustment.
Minimum Bandwidth

Displays the minimum planned bandwidth that you have specified for the tunnel.

If the aggregate LSP traffic is lesser than both the current bandwidth and the minimum bandwidth and if the difference exceeds the adjustment threshold (in %) and minimum variation threshold values, then the new planned bandwidth of the LSP will be set to the minimum bandwidth value.

The valid units are B or b, M or m, K or k, or G or g.

Examples: 50M, 1000b, 25g.
Maximum Bandwidth

Displays the maximum planned bandwidth that you have specified for the tunnel.

If the aggregate LSP traffic is greater than the maximum bandwidth value and the current bandwidth, and if the difference between LSP traffic and current bandwidth exceeds the adjustment threshold (in %) and minimum variation threshold values, then the new planned bandwidth of the LSP will be set to the maximum bandwidth value.

The valid units are B or b, M or m, K or k, or G or g.

Examples: 50M, 1000b, 25g.
Minimum Variation Threshold

Displays the sensitivity of the automatic bandwidth adjustment when the new planned bandwidth is compared with the current planned bandwidth.

The new planned bandwidth is only considered if the difference is greater than or equal to the value you have specified here. Because it is not a percentage, this is used to prevent small fluctuations from triggering unnecessary bandwidth changes.

If both the adjustment threshold and the minimum variation threshold are greater than zero, both settings are taken into consideration. The new planned bandwidth is considered if the percentage difference is greater than or equal to the adjustment threshold and the actual difference is greater than or equal to the minimum variation.
Routing Method Displays the routing method of the tunnel - Default, Delay, ISIS, OSPF, and Route By Device.
SID Compression

Displays whether the Segment ID (SID) compression is enabled (Yes) or disabled (No) for the tunnel.

If you have enabled SID Compression, multiple labels along a path are compressed and reduced to the destination node SID. You can view the label in the Record Route field.

Related Documentation