Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

header-navigation
keyboard_arrow_up
close
keyboard_arrow_left
Network Management and Monitoring Guide
Table of Contents Expand all
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
keyboard_arrow_right

Configure Hardware Resource Threshold Monitoring for Capacity Planning

date_range 09-Oct-24

This topic describes hardware resource threshold monitoring, how to configure a resource list, associate a resource list to a monitor profile, how to configure the polling interval, and the operational mode commands to display the hardware resource utilization.

Hardware Resource Threshold Monitoring

To configure hardware resource threshold monitoring, create a resource list and specify which hardware resources to monitor or monitor all your hardware resources. You can choose several options to enhance resource lists. You can also configure a monitor profile with these optional settings that can be applied to your resource lists. You can specify a polling interval for how often hardware resource data is polled. The upper, lower thresholds, and notification type can be configured. Whenever a threshold is breached you receive notification.

Configure a Resource List

Create a resource list to monitor hardware resource utilization.

You can configure multiple resource lists, but the same resource can only be used once and cannot be duplicated on multiple resource lists.

Once configured, hardware resource utilization data is periodically polled. Default polling interval is one second.

To configure a resource list :

  1. In configuration mode, go to the [edit system packet-forwarding-options hw-resource-monitor resource-list] hierarchy level and add a name for your resource list (here, R1):
    content_copy zoom_out_map
    [edit]
    user@host# set system packet-forwarding-options hw-resource-monitor resource-list <resource-list-name> resource-names <resource-names/ all-resources>
  2. Use the all-resources statement to monitor all available resources:
    content_copy zoom_out_map
    [edit system packet-forwarding-options hw-resource-monitor resource-list R1] 
    user@host# set resource-names all-resources
    To monitor multiple resource names, separate each resource name with a space, for example:
    content_copy zoom_out_map
    [edit system packet-forwarding-options hw-resource-monitor resource-list R1] 
    user@host# set resource-names efp ifp vfp
    Where efp, ifp, and vfp are the resources.
    You can map a resource list with a monitor profile (optional) and configure the upper, lower thresholds, and notification type of the monitor profile. You can also configure the polling interval (optional).

Configure the Polling Interval (optional)

You can optionally configure a single polling interval for the all the applicable resources.

To configure the polling interval:

In configuration mode, go to the [edit system packet-forwarding-options hw-resource-monitor] hierarchy level and configure the polling interval:
content_copy zoom_out_map
set system packet-forwarding-options hw-resource-monitor polling-interval <10-86400000 milliseconds>
Default polling interval is one second.

Associate a Monitor Profile (optional)

You can optionally map a configured resource list with a monitor profile. A monitor-profile can be mapped to multiple resource-lists, but a single resource-list cannot be mapped to multiple monitor-profiles. A resource-list can be mapped only to a single monitor-profile. Configure a monitor profile before you map it to a resource list.

To associate a monitor profile:

  1. For a monitor profile, you can optionally configure the lower threshold, upper threshold, and the notification type.
    To configure the lower threshold, go to the [edit system packet-forwarding-options hw-resource-monitor monitor-profile] hierarchy level:
    content_copy zoom_out_map
    set system packet-forwarding-options hw-resource-monitor monitor-profile <monitor-profile-name> lower-threshold <1-100> 

    When the lower threshold is breached, a minor notification is raised. The default value is "50".

    To configure the upper threshold, go to the [edit system packet-forwarding-options hw-resource-monitor monitor-profile]:

    content_copy zoom_out_map
    set system packet-forwarding-options hw-resource-monitor monitor-profile <monitor-profile-name> upper-threshold <1-100> 

    When the upper threshold is breached, a major notification is raised. The default value is "90".

    To configure the notification type, go to the [edit system packet-forwarding-options hw-resource-monitor monitor-profile]:

    content_copy zoom_out_map
    set system packet-forwarding-options hw-resource-monitor monitor-profile <monitor-profile-name> notification type <syslog/alarms/none>

    The notification type can be syslog, alarm, or none. The default value is "syslog".

  2. In configuration mode, go to the [edit system packet-forwarding-options hw-resource-monitor resource-list] hierarchy level and map a monitor profile:
    content_copy zoom_out_map
    [edit]
    user@host# set system packet-forwarding-options hw-resource-monitor resource-list <resource-list-name> monitor-profile <monitor-profile-name>
  3. If you configure an optional monitor profile, use the show system packet-forwarding-options hw-resource-monitor monitor-profile command in configuration mode to display the configured upper and lower threshold values (set as the boundary for a hardware resource) and the notification type issued when a resource's utilization rate crosses a threshold boundary.
  4. In configuration mode, ([edit]), use the run show system packet-forwarding-options hw-resource-monitor resource-list command to display the hardware resources contained in a resource list.

Monitor Utlilization

Use the following operational mode command to display the hardware resources configured under a resource-list. The current resource utilization utilization, upper threshold, lower threshold, health, and notification type values are displayed.

show system packet-forwarding-options hw-resource-monitor utilization-info
content_copy zoom_out_map
Slot 0
 
 
***** HW Resource Monitoring Information  *****
 
Polling Interval: 1000 milliseconds (1 seconds)
 
HW Resource Name    | Max Capacity | Current Utilization | Current Utilization % | Lower Threshold % | Upper Threshold % | Health | Notification Type
--------------------|--------------|---------------------|-----------------------|-------------------|-------------------|--------|------------------
ECMP-GROUP          | 4096         | 0                   | 0                     | 50                | 90                | GREEN  | Sylog
ECMP-MEMBER         | 32768        | 0                   | 0                     | 50                | 90                | GREEN  | Sylog
EFP                 | 2048         | 0                   | 0                     | 50                | 90                | GREEN  | Sylog
EGRESS-L3-INTERFACE | 16384        | 7                   | 1                     | 50                | 90                | GREEN  | Sylog
HOST-IPv4           | 147456       | 21                  | 1                     | 50                | 90                | GREEN  | Sylog
HOST-IPv6           | 73728        | 5                   | 1                     | 50                | 90                | GREEN  | Sylog
IFP                 | 18432        | 182                 | 1                     | 50                | 90                | GREEN  | Sylog
L3-NEXT-HOP         | 65536        | 10                  | 1                     | 50                | 90                | GREEN  | Sylog
LPM-IPv4            | 24576        | 8                   | 1                     | 50                | 90                | GREEN  | Sylog
LPM-IPv6-128        | 2048         | 0                   | 0                     | 50                | 90                | GREEN  | Sylog
LPM-IPv6-64         | 12288        | 4                   | 1                     | 50                | 90                | GREEN  | Sylog
MAC                 | 163840       | 2                   | 1                     | 50                | 90                | GREEN  | Sylog
MPLS-INGRESS        | 16384        | 0                   | 0                     | 50                | 90                | GREEN  | Sylog
MPLS-SWAP           | 16384        | 0                   | 0                     | 50                | 90                | GREEN  | Sylog
TUNNEL              | 4096         | 0                   | 0                     | 50                | 90                | GREEN  | Sylog
VFP                 | 1024         | 0                   | 0                     | 50                | 90                | GREEN  | Sylog
VPORT               | 16384        | 0                   | 0                     | 50                | 90                | GREEN  | Sylog
IFP-DYN-GROUP       | 6144         | 364                 | 5                     | 50                | 90                | GREEN  | Sylog
 
{master:0}

To view the alarms, use the show system alarms command. To view the log messages, use the show log messages command.

Whenever there is a change in resource health, notifications are raised or cleared as required depending upon the notification type (alarm or syslog). Green indicates that the hardware resource utilization is safely within threshold boundaries. Yellow indicates that the hardware resource utilization is above the lower threshold but within the upper threshold. Red indicates that the hardware resource utilization is above the the upper threshold. When the resource health changes from Green to Yellow or vice-versa, a minor alarm is raised or cleared (as applicable). When the resource health changes from Yellow to Red or vice-versa, a major alarm is raised or cleared (applicable only if the notification type is alarm). When the resource health changes from Green to Yellow, a syslog WARNING is logged (as applicable). When the resource health changes from Yellow to Red, a syslog CRITICAL is logged (applicable only if the notification type is syslog).

Enter the show system packet-forwarding-options hw-resource-utilization-info command to display the maximum capacity and current utilization for all the applicable resources. This command can be used to display the utilization of hardware resources even if resource lists are not configured.

For example:

content_copy zoom_out_map
Slot 0
 
 
***** HW Resource Maximum Capacity and Current Usage *****
 
HW Resource Name    | Max Capacity | Current Utilization | Current Utilization %
--------------------|--------------|---------------------|----------------------
ecmp-group          | 4096         | 0                   | 0
ecmp-member         | 32768        | 0                   | 0
efp                 | 2048         | 0                   | 0
egress-l3-interface | 16384        | 7                   | 1
host-ipv4           | 147456       | 21                  | 1
host-ipv6           | 73728        | 5                   | 1
ifp                 | 18432        | 182                 | 1
l3-next-hop         | 65536        | 10                  | 1
lpm-ipv4            | 24576        | 8                   | 1
lpm-ipv6-128        | 2048         | 0                   | 0
lpm-ipv6-64         | 12288        | 4                   | 1
mac                 | 163840       | 2                   | 1
mpls-ingress        | 16384        | 0                   | 0
mpls-swap           | 16384        | 0                   | 0
tunnel              | 4096         | 0                   | 0
vfp                 | 1024         | 0                   | 0
vport               | 16384        | 0                   | 0

HW Resource Monitoring: npu/memory/ sensor (JTI)

View the monitored data using operational mode commands or use Junos Telemetry interface (JTI) to send data from your device to a collector using the resource path /junos/system/linecard/npu/memory/.

Sample output:

content_copy zoom_out_map
kv {
  key:property[name='mem-util-host-v4-size']/state/value,
  uint_value:147456
}
kv {
  key:property[name='mem-util-host-v4-allocated']/state/value,
  uint_value:12
}
kv {
  key:property[name='mem-util-host-v4-utilization']/state/value,
  int_value:1
}
kv {
  key:property[name='mem-util-host-v4-lower-threshold']/state/value,
  uint_value:50
}
kv {
  key:property[name='mem-util-host-v4-upper-threshold']/state/value,
uint_value:90
}
kv {
  key:property[name='mem-util-host-v4-health']/state/value,
  uint_value:1
}

If resource lists are not configured, the threshold and health values will be "0" and not displayed in the sensor output because of zero-suppression.

footer-navigation