Dynamic Multipoint VPN Configuration Guide, Cisco IOS XE Release 3S (Cisco ASR 1000)
DMVPN Event Tracing
Downloads: This chapterpdf (PDF - 118.0KB) The complete bookPDF (PDF - 1.38MB) | The complete bookePub (ePub - 1.12MB) | Feedback

DMVPN Event Tracing

DMVPN Event Tracing

Last Updated: March 28, 2013

The DMVPN Event Tracing feature provides a trace facility for troubleshooting Cisco IOS Dynamic Multipoint VPN (DMVPN). This feature enables you to monitor DMVPN events, errors, and exceptions. During runtime, the event trace mechanism logs trace information in a buffer space. A display mechanism extracts and decodes the debug data.

You can use the DMVPN Event Tracing feature to analyze the cause of a device failure. When you configure the DMVPN Event Tracing feature, the router logs messages from specific DMVPN subsystem components into the device memory. You can view trace messages stored in the memory or save them to a file.

Finding Feature Information

Your software release may not support all the features documented in this module. For the latest caveats and feature information, see Bug Search Tool and the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the feature information table at the end of this module.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.

Information About DMVPN Event Tracing

Benefits of DMVPN Event Tracing

  • Displays debug information on the console during runtime.
  • Avoids multiple debug calls, and hence improves device performance.
  • Saves memory space.

DMVPN Event Tracing Options

The DMVPN Event Tracing feature defines the event data type, provides functionalities to capture the event, and prints the events and the CLI extensions required to access and modify the log. The table below lists different options that can be monitored using the DMVPN Event Tracing feature.

Table 1 DMVPN Event Trace Options

Event Type

Description

NHRP Event Trace

General Next Hop Resolution Protocol (NHRP) events, such as NHRP protocol, NHRP messages, changes in NHRP data structure, NHRP NBMA or protocol address change, and NHRP traps.

NHRP Error Trace

All NHRP error events.

NHRP Exception Trace

All NHRP exception events.

Tunnel Event Trace

All tunnel events.

How to Configure DMVPN Event Tracing

You can configure the DMVPN Event Tracing feature in privileged EXEC mode or global configuration mode based on the desired parameters. See the Cisco IOS Security Command Reference for information on different parameters available in privileged EXEC mode or global configuration mode.

Perform one of the following tasks to configure the DMVPN Event Tracing feature:

Configuring DMVPN Event Tracing in Privileged EXEC Mode

Perform this task to configure DMVPN event tracing in privileged EXEC mode.

SUMMARY STEPS

1.    enable

2.    monitor event-trace dmvpn {nhrp {error | event | exception} | tunnel} {clear | continuous [cancel] | disable | enable | one-shot} | tunnel}


DETAILED STEPS
  Command or Action Purpose
Step 1
enable


Example:

Router> enable

 

Enables privileged EXEC mode.

  • Enter your password if prompted.
 
Step 2
monitor event-trace dmvpn {nhrp {error | event | exception} | tunnel} {clear | continuous [cancel] | disable | enable | one-shot} | tunnel}


Example:

Router# monitor event-trace dmvpn nhrp error enable

 

Monitors and controls DMVPM traces.

 

Configuring DMVPN Event Tracing in Global Configuration Mode

Perform this task to configure DMVPN event tracing in global configuration mode.

SUMMARY STEPS

1.    enable

2.    configure terminal

3.    monitor event-trace dmvpn {dump-file url | {nhrp {error | event | exception} | tunnel} {disable | dump-file url | enable | size | stacktrace value}}

4.    exit


DETAILED STEPS
  Command or Action Purpose
Step 1
enable


Example:

Router> enable

 

Enables privileged EXEC mode.

  • Enter your password if prompted.
 
Step 2
configure terminal


Example:

Router# configure terminal

 

Enters global configuration mode.

 
Step 3
monitor event-trace dmvpn {dump-file url | {nhrp {error | event | exception} | tunnel} {disable | dump-file url | enable | size | stacktrace value}}


Example:

Router(config)# monitor event-trace dmvpn nhrp error enable

 

Monitors and controls DMVPM traces.

 
Step 4
exit


Example:

Router(config)# exit

 

Exits global configuration mode.

 

Configuration Examples for DMVPN Event Tracing

Example Configuring DMVPN Event Tracing in Privileged EXEC Mode

The following example shows how to monitor NHRP error traces in privileged EXEC mode:

Router> enable
Router# monitor event-trace dmvpn nhrp error enable

Example Configuring DMVPN Event Tracing in Global Configuration Mode

The following example shows how to monitor NHRP error traces in global configuration mode:

Router> enable
Router# configure terminal
Router(config)# monitor event-trace dmvpn nhrp error enable

Additional References

Related Documents

Related Topic

Document Title

Cisco IOS commands

Cisco IOS Master Commands List, All Releases

DMVPN commands

Cisco IOS Security Command Reference

Standards

Standard

Title

None

--

MIBs

MIB

MIBs Link

None

--

RFCs

RFC

Title

None

--

Technical Assistance

Description

Link

The Cisco Support and Documentation website provides online resources to download documentation, software, and tools. Use these resources to install and configure the software and to troubleshoot and resolve technical issues with Cisco products and technologies. Access to most tools on the Cisco Support and Documentation website requires a Cisco.com user ID and password.

http://www.cisco.com/cisco/web/support/index.html

Feature Information for DMVPN Event Tracing

The following table provides release information about the feature or features described in this module. This table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.

Table 2 Feature Information for DMVPN Event Tracing

Feature Name

Releases

Feature Information

DMVPN Event Tracing

Cisco IOS XE Release 3.9S

The DMVPN Event Tracing feature provides a trace facility for troubleshooting Cisco IOS DMVPN. This feature enables you to monitor DMVPN events, errors, and exceptions. During runtime, the event trace mechanism logs trace information in a buffer space. A display mechanism extracts and decodes the debug data.

The following commands were introduced or modified: monitor event-trace dmvpn, show monitor event-trace dmvpn.

Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks . Third party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1005R)

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1110R)

Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.

© 2013 Cisco Systems, Inc. All rights reserved.