Configuring the resource usage counter for multicast streams

Configure the resource usage counters to query the number of ingress and egress IP multicast streams traversing the switch.

About this task

Note

This procedure is supported only on a DvR Controller. It is not supported on a DvR Leaf node.

After you configure the counter thresholds for ingress and egress records, if the record usage exceeds the threshold, you receive notification by a trap on the console, a logged message, or both.

If you do not configure the thresholds, the system displays only the ingress and egress records currently in use.

You can configure the resource usage counter on a VRF instance the same way you configure the Global Router except that you must use VRF Router Configuration mode.

Procedure

Enter Global Configuration mode:

enable

configure terminal
Configure the thresholds:

ip mroute resource-usage egress-threshold <0–32767> ingress-threshold <0–32767>
Configure one of the following notification methods:
- Configure a log-only notification method:
  
  ip mroute resource-usage log-msg
- Configure a trap-only notification method:
  
  ip mroute resource-usage trap-msg
- Configure both notification methods:
  
  ip mroute resource-usage log-msg trap-msg

Example

Configure the egress threshold to 200.

Switch:1(config)# ip mroute resource-usage egress-threshold 200

Configure the ingress threshold to 100.

Switch:1(config)# ip mroute resource-usage ingress-threshold 100

Enable the log message notification method.

Switch:1(config)# ip mroute resource-usage log-msg

Variable definitions

Use the data in the following table to use the ip mroute resource-usage command.


Variable	Value
egress-threshold `<0–32767>`	Configures the egress record threshold (S,G). The system sends a notification message after the number of streams exceeds a threshold level. To configure this option to the default value, use the default operator with the command. The default is 0.
ingress-threshold `<0–32767>`	Configures the ingress record threshold. The system sends a notification message after the number of streams exceeds a threshold level. To configure this option to the default value, use the default operator with the command. The default is 0.