Skip to content

Commit

Permalink
removed 330314 from 4.12
Browse files Browse the repository at this point in the history
  • Loading branch information
rachel-netq committed Oct 21, 2024
1 parent fdfa735 commit ceb2d3e
Show file tree
Hide file tree
Showing 3 changed files with 19 additions and 24 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -5,9 +5,7 @@ weight: 790
toc: 3
---

Threshold-crossing events are user-defined events that detect and prevent network failures for ACL resources, BGP, digital optics, ECMP, forwarding resources, interface errors and statistics, link flaps, resource utilization, RoCE, sensors, and What Just Happened events.

NetQ configures some threshold crossing rules by default. You can find a complete list of TCAs---including event IDs required for the command line---in the {{<link title="Threshold-Crossing Events Reference" text="Threshold-Crossing Events Reference">}}.
Threshold-crossing events are user-defined events that detect and prevent network failures for ACL resources, BGP, digital optics, ECMP, forwarding resources, interface errors and statistics, link flaps, resource utilization, RoCE, sensors, and What Just Happened events. You can find a complete list of TCAs---including event IDs required for the command line---in the {{<link title="Threshold-Crossing Events Reference" text="Threshold-Crossing Events Reference">}}.

<!--
Expand Down Expand Up @@ -761,7 +759,7 @@ To reenable the rule, set the `is_active` option to *true*.

### Delete a Rule

Some rules—for example those set up by default—cannot be deleted.
<!--removed for 4.12. Some rules—for example those set up by default—cannot be deleted.-->

{{<tabs "TabID2858" >}}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ toc: 4

This reference lists the threshold-based events that NetQ supports. You can view these messages through third-party notification applications. For details about configuring notifications for these events, refer to {{<link title="Configure and Monitor Threshold-Crossing Events">}}.

Items marked with an asterisk (*) indicate threshold-crossing events that NetQ configures by default across all premises. You can {{<link title="Configure and Monitor Threshold-Crossing Events/#Manage-Threshold-crossing-Events and-Notifications" text="edit the threshold values">}} for default rules or disable them to prevent NetQ from generating events.
<!--hiding for 4.12 Items marked with an asterisk (*) indicate threshold-crossing events that NetQ configures by default across all premises. You can {{<link title="Configure and Monitor Threshold-Crossing Events/#Manage-Threshold-crossing-Events and-Notifications" text="edit the threshold values">}} for default rules or disable them to prevent NetQ from generating events.-->

## ACL Resources

Expand Down Expand Up @@ -38,7 +38,7 @@ Items marked with an asterisk (*) indicate threshold-crossing events that NetQ c
<!-- vale off -->
| NetQ UI Name | NetQ CLI Event ID | Description |
| --- | --- | --- |
| BGP connection drop* | TCA_BGP_CONN_DROP | Increase in drop count for a BGP session exceeding user-defined threshold |
| BGP connection drop | TCA_BGP_CONN_DROP | Increase in drop count for a BGP session exceeding user-defined threshold |
| BGP packet queue length | TCA_BGP_PACKET_QUEUE_LENGTH | Packet queue length persistently non-zero for more than the threshold duration (in seconds) |

## Digital Optics
Expand Down Expand Up @@ -114,7 +114,7 @@ Items marked with an asterisk (*) indicate threshold-crossing events that NetQ c
<!-- vale off -->
| NetQ UI Name | NetQ CLI Event ID | Description |
| --- | --- | --- |
| ECMP imbalance* | TCA_ECMP_IMBALANCE | ECMP path utilization imbalance greater than the threshold |
| ECMP imbalance | TCA_ECMP_IMBALANCE | ECMP path utilization imbalance greater than the threshold |


## Forwarding Resources
Expand All @@ -123,8 +123,8 @@ Items marked with an asterisk (*) indicate threshold-crossing events that NetQ c
| --- | --- | --- |
| Total route entries % | TCA_TCAM_TOTAL_ROUTE_ENTRIES_UPPER | Number of routes on a given switch or host exceeded user-defined maximum threshold |
| Mcast routes % | TCA_TCAM_TOTAL_MCAST_ROUTES_UPPER | Number of multicast routes on a given switch or host exceeded user-defined maximum threshold |
| MAC entries %* | TCA_TCAM_MAC_ENTRIES_UPPER | Number of MAC addresses on a given switch or host exceeded user-defined maximum threshold |
| IPv4 routes %* | TCA_TCAM_IPV4_ROUTE_UPPER | Number of IPv4 routes on a given switch or host exceeded user-defined maximum threshold |
| MAC entries % | TCA_TCAM_MAC_ENTRIES_UPPER | Number of MAC addresses on a given switch or host exceeded user-defined maximum threshold |
| IPv4 routes % | TCA_TCAM_IPV4_ROUTE_UPPER | Number of IPv4 routes on a given switch or host exceeded user-defined maximum threshold |
| IPv4 hosts % | TCA_TCAM_IPV4_HOST_UPPER | Number of IPv4 hosts on a given switch or host exceeded user-defined maximum threshold |
| Exceeding IPv6 routes % | TCA_TCAM_IPV6_ROUTE_UPPER | Number of IPv6 routes on a given switch or host exceeded user-defined maximum threshold |
| IPv6 hosts % | TCA_TCAM_IPV6_HOST_UPPER | Number of IPv6 hosts on a given switch or host exceeded user-defined maximum threshold |
Expand All @@ -138,7 +138,7 @@ Items marked with an asterisk (*) indicate threshold-crossing events that NetQ c
| Undersize errors | TCA_HW_IF_UNDERSIZE_ERRORS | Number of times a frame shorter than minimum size (64 Bytes) exceeded user-defined threshold |
| Alignment errors | TCA_HW_IF_ALIGNMENT_ERRORS | Number of times a frame with an uneven byte count and a CRC error exceeded user-defined threshold |
| Jabber errors | TCA_HW_IF_JABBER_ERRORS | Number of times a frame longer than maximum size (1518 bytes) and with a CRC error exceeded user-defined threshold |
| Symbol errors* | TCA_HW_IF_SYMBOL_ERRORS | Number of times that detected undefined or invalid symbols exceeded user-defined threshold |
| Symbol errors | TCA_HW_IF_SYMBOL_ERRORS | Number of times that detected undefined or invalid symbols exceeded user-defined threshold |

## Interface Statistics

Expand All @@ -155,17 +155,17 @@ Items marked with an asterisk (*) indicate threshold-crossing events that NetQ c

| NetQ UI Name | NetQ CLI Event ID | Description |
| --- | --- | --- |
| Link flap errors* | TCA_LINK_FLAP_UPPER | Number of link flaps exceeded user-defined maximum threshold |
| Link flap errors | TCA_LINK_FLAP_UPPER | Number of link flaps exceeded user-defined maximum threshold |

## Resource Utilization

| NetQ UI Name | NetQ CLI Event ID | Description |
| --- | --- | --- |
| Service memory utilization | TCA_SERVICE_MEMORY_UTILIZATION_UPPER | Percentage of service memory utilization exceeded user-defined maximum threshold on a switch |
| Disk utilization* | TCA_DISK_UTILIZATION_UPPER | Percentage of disk utilization exceeded user-defined maximum threshold on a switch or host |
| CPU utilization* | TCA_CPU_UTILIZATION_UPPER | Percentage of CPU utilization exceeded user-defined maximum threshold on a switch or host |
| Disk utilization | TCA_DISK_UTILIZATION_UPPER | Percentage of disk utilization exceeded user-defined maximum threshold on a switch or host |
| CPU utilization | TCA_CPU_UTILIZATION_UPPER | Percentage of CPU utilization exceeded user-defined maximum threshold on a switch or host |
| Service CPU utilization | TCA_SERVICE_CPU_UTILIZATION_UPPER | Percentage of service CPU utilization exceeded user-defined maximum threshold on a switch |
| Memory utilization* | TCA_MEMORY_UTILIZATION_UPPER | Percentage of memory utilization exceeded user-defined maximum threshold on a switch or host |
| Memory utilization | TCA_MEMORY_UTILIZATION_UPPER | Percentage of memory utilization exceeded user-defined maximum threshold on a switch or host |

## RoCE

Expand Down Expand Up @@ -196,8 +196,8 @@ Items marked with an asterisk (*) indicate threshold-crossing events that NetQ c
| Fan speed | TCA_SENSOR_FAN_UPPER | Fan speed exceeded user-defined maximum threshold on a switch |
| Power supply watts | TCA_SENSOR_POWER_UPPER| Power supply output exceeded user-defined maximum threshold on a switch |
| Power supply volts | TCA_SENSOR_VOLTAGE_UPPER | Power supply voltage exceeded user-defined maximum threshold on a switch |
| Switch temperature* | TCA_SENSOR_TEMPERATURE_UPPER | Temperature (&deg; C) exceeded user-defined maximum threshold on a switch |
| Sensor state* | TCA_SENSOR_STATE | Sensor state changed from good to either bad or absent |
| Switch temperature | TCA_SENSOR_TEMPERATURE_UPPER | Temperature (&deg; C) exceeded user-defined maximum threshold on a switch |
| Sensor state | TCA_SENSOR_STATE | Sensor state changed from good to either bad or absent |

## What Just Happened

Expand Down Expand Up @@ -265,6 +265,4 @@ Items marked with an asterisk (*) indicate threshold-crossing events that NetQ c
| Symbol error upper | TCA_WJH_SYMBOL_ERROR_UPPER | L1 | Link training failure | Link is not able to go operational up due to link training failure |
| Symbol error upper | TCA_WJH_SYMBOL_ERROR_UPPER | L1 | Peer is sending remote faults | Peer node is not operating correctly |
| Symbol error upper | TCA_WJH_SYMBOL_ERROR_UPPER | L1 | Port admin down | Port has been purposely set down by user |
<!-- vale on -->

*Threshold-crossing event created by default
<!-- vale on -->
9 changes: 4 additions & 5 deletions content/cumulus-netq-412/Whats-New/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,23 +17,22 @@ NetQ 4.12.0 includes the following new features and improvements:
- Compare interfaces and view counter data across links with the {{<link title="Interfaces/#compare-link-interfaces" text="link health view">}}
- The {{<link title="Network Topology" text="topology view">}} is now generally available
- {{<link title="Validate Network Protocol and Service Operations/#topology-validations" text="Topology validations">}} are now generally available
- Some {{<link title="Threshold-Crossing Events Reference" text="threshold-crossing events">}} are now configured by NetQ by default
- View a switch's BGP and EVPN session information from the full-screen {{<link title="Switches" text="switch dashboard">}}

## Upgrade Paths

For deployments running:

- 4.10, 4.9: {{<link title="Upgrade NetQ Virtual Machines" text="upgrade directly">}} to NetQ 4.11
- 4.8 or earlier: {{<link title="Back Up and Restore NetQ" text="back up your NetQ data">}} and perform a {{<link title="Install the NetQ System" text="new installation">}}
- 4.11, 4.10: {{<link title="Upgrade NetQ Virtual Machines" text="upgrade directly">}} to NetQ 4.12
- 4.9 or earlier: {{<link title="Back Up and Restore NetQ" text="back up your NetQ data">}} and perform a {{<link title="Install the NetQ System" text="new installation">}}

## Compatible Agent Versions

The NetQ 4.12 server is compatible with NetQ Agent 4.10 or later. You can install NetQ Agents on switches and servers running:

- Cumulus Linux 5.0.0 or later (Spectrum switches)
- Cumulus Linux 4.3.1, 4.3.2 (Broadcom switches)
- Ubuntu 20.04, 22.04
- Cumulus Linux 4.3.2, 4.3.1 (Broadcom switches)
- Ubuntu 22.04, 20.04

You must upgrade to the latest agent version to enable 4.12 features.

Expand Down

0 comments on commit ceb2d3e

Please sign in to comment.