https://github.com/cisco-en-programmability/dnacenter_path_trace

Sample code for performing a path trace between two nodes in the Cisco DNA Center managed network
https://github.com/cisco-en-programmability/dnacenter_path_trace

cisco-dna cisco-dna-center cisco-dnac

Last synced: 25 days ago
JSON representation

Sample code for performing a path trace between two nodes in the Cisco DNA Center managed network

• Host: GitHub
• URL: https://github.com/cisco-en-programmability/dnacenter_path_trace
• Owner: cisco-en-programmability
• License: other
• Created: 2019-08-29T16:56:34.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2019-12-13T01:49:13.000Z (almost 5 years ago)
• Last Synced: 2024-08-03T20:02:58.833Z (4 months ago)
• Topics: cisco-dna, cisco-dna-center, cisco-dnac
• Language: Python
• Size: 35.2 KB
• Stars: 1
• Watchers: 2
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• awesome-cisco-dnac - dnacenter_path_trace

README

        
# Cisco DNA Center Path Trace

This Python script will perform Path Trace between two clients in the Cisco DNA Center managed network.

Path Trace is a excellent tool to assist in troubleshooting connectivity between a source device and destination device.

Path Trace will collect the path information for specified source and destination IPv4 addresses, and optional, source and destination port numbers, and protocol number.

It will collect also information about in-path statistics for interfaces, interface configured ACLs and QoS policies, and device statistics

**Cisco Products & Services:**

- Cisco DNA Center

**Tools & Frameworks:**

- Python environment

**Usage**

This app will ask the user to input the following:

- Source IPv4 Address

- Source port number (or Enter for none)

- Destination IPv4 Address

- Destination port number (or Enter for none)

- Protocol number (or Enter for none)

It will validate if the provided IPv4 addresses, ports and protocol numbers are valid.

It will initiate a new flow analysis, verify when the task is completed, retrieve the Path Trace details, parse the output and provide the hop-by-hop info.

$ python path_trace.py 

*Sample output:*

    Input the source IPv4 Address:   10.93.140.35

    Input the source port number (or Enter for none):   5500

    Input the destination IPv4 Address:   10.93.234.96

    Input the destination port number (or Enter for none):   80

    Input the protocol number (or Enter for none):   6

    

    Initiated Path Trace with these parameters:

    {

        "destIP" : "10.93.234.96" , 

        "sourceIP" : "10.93.140.35" , 

        "periodicRefresh" : false , 

        "inclusions" : [

            "INTERFACE-STATS" , 

            "DEVICE-STATS" , 

            "ACL-TRACE" , 

            "QOS-STATS"

        ] , 

        "sourcePort" : 5500 , 

        "destPort" : 80 , 

        "protocol" : 6

    }

    

    Initiated Path Trace with the id: 

    a1bba53b-5d80-4aba-9372-573645077ee9

    

    

    The complete path trace info is: 

    

    {

        "request" : {

            "sourceIP" : "10.93.140.35" , 

            "sourcePort" : "5500" , 

            "destIP" : "10.93.234.96" , 

            "destPort" : "80" , 

            "protocol" : "6" , 

            "periodicRefresh" : false , 

            "inclusions" : [

                "INTERFACE-STATS" , 

                "ACL-TRACE" , 

                "DEVICE-STATS" , 

                "QOS-STATS"

            ] , 

            "id" : "a1bba53b-5d80-4aba-9372-573645077ee9" , 

            "status" : "COMPLETED" , 

            "createTime" : 1574879612290 , 

            "lastUpdateTime" : 1574879612878 , 

            "controlPath" : false

            .....

            .....

            .....

            }

    

    Path Trace status:  COMPLETED

    

    Path Trace result:

    [

        "10.93.140.35" , 

        "TenGigabitEthernet1/0/1" , 

        "NYC-ACCESS" , 

        "TenGigabitEthernet1/0/24" , 

        "GigabitEthernet2" , 

        "NYC-RO" , 

        "GigabitEthernet3" , 

        "GigabitEthernet3" , 

        "SP" , 

        "GigabitEthernet2" , 

        "GigabitEthernet2" , 

        "PDX-RO" , 

        "GigabitEthernet1" , 

        "GigabitEthernet1/0/13" , 

        "PDX-M" , 

        "GigabitEthernet1/0/20" , 

        "FastEthernet0" , 

        "PDX-DMZ" , 

        "10.93.234.96"

    ]

    

    

    End of Application "path_trace.py" Run

**License**

This project is licensed to you under the terms of the [Cisco Sample Code License](./LICENSE).