This documentation has been moved
DMVPN Event Tracing
Download this chapter
DMVPN Event Tracing DMVPN Event Tracing
Download the complete book
Cisco IOS Security Configuration Guide: Secure Connectivity, Release 15.1Cisco IOS Security Configuration Guide: Secure Connectivity, Release 15.1 (PDF - 8 MB)
 Feedback

Table Of Contents

DMVPN Event Tracing

Finding Feature Information

Contents

Information About DMVPN Event Tracing

Benefits of DMVPN Event Tracing

DMVPN Event Tracing Options

How to Configure DMVPN Event Tracing

Configuring DMVPN Event Tracing in Privileged EXEC Mode

Configuring DMVPN Event Tracing in Global Configuration Mode

Configuration Examples for DMVPN Event Tracing

Example: Configuring DMVPN Event Tracing in Privileged EXEC Mode

Example: Configuring DMVPN Event Tracing in Global Configuration Mode

Additional References

Related Documents

Standards

MIBs

RFCs

Technical Assistance

Feature Information for DMVPN Event Tracing


DMVPN Event Tracing

First Published: March 25, 2011
Last Updated: March 25, 2011

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 feature information and caveats, see 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 for DMVPN Event Tracing" section.

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

Contents

•Information About DMVPN Event Tracing

•How to Configure DMVPN Event Tracing

•Configuration Examples for DMVPN Event Tracing

•Additional References

•Feature Information for DMVPN Event Tracing

Information About DMVPN Event Tracing

•Benefits of DMVPN Event Tracing

•DMVPN Event Tracing Options

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. Table 1 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 (required)

•Configuring DMVPN Event Tracing in Global Configuration Mode (required)

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 {dump [merged] pretty | {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

•Example: Configuring DMVPN Event Tracing in Global Configuration Mode

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

Table 2 lists the release history for this feature.

Use Cisco Feature Navigator to find information about platform support and software image support. Cisco Feature Navigator enables you to determine which software images support a specific software release, feature set, or platform. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.

Note Table 2 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.

Table 2 Feature Information for DMVPN Event Tracing 

Feature Name
Releases
Feature Information

DMVPN Event Tracing

15.1(4)M

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)

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.

© 2011 Cisco Systems, Inc. All rights reserved.