System Monitoring Command Reference for Cisco NCS 5500 Series, Cisco NCS 540 Series, and Cisco NCS 560 Series Routers

show tech-support custom

To generate and gather tech-support information related to a specific area such as network traffic, control-plane, and the system, use the show tech-support custom command in EXEC mode.

show tech-support custom { traffic | control-plane | system | sysadmin }

Syntax Description


traffic	Generates tech-support information related to network traffic.
control-plane	Generates tech-support information related to the control-plane.
system	Generates tech-support information related to the system.
sysadmin	Generates tech-support information related to the system-admin profile.

Command Default

None

Command Modes

EXEC mode

Config mode

Command History


Release	Modification
Release 7.3.6	The sysadmin option was introduced.
Release 7.3.5	This command was introduced.

Usage Guidelines

This command generates tech-support information that is useful for Cisco Technical Support representatives when troubleshooting a router. By default, the output of this command is saved on the router's hard disk in a file with .tgz extension. You can share this file with Cisco Technical Support. To share, use the copy command to copy the .tgz file to a server or local machine. For example, copy harddisk:/showtech/ name.tgz tftp:// server_path .

For Cisco Technical Support contact information, see the 'Obtaining Documentation and Submitting a Service Request' section in the Preface.

Table 1. List of Commands collected by each custom option
Custom Option	Release	List of commands outputs collected
Control-plane	Release 7.3.6	show tech-support aib show tech-support ipv6 nd show tech-support arp show tech-support service-layer show tech-support routing bgp show tech-support routing isis show tech-support routing bfd show tech-support bfdhwoff show tech-support mpls ldp show tech-support bcdlv2 show tech-support rib show tech-support mpls lsd show tech-support cef show tech-support cef platform show tech-support gsp show tech-support l2rib show tech-support l2vpn show tech-support lpts show tech-support spp show tech-support clns show tech-support fabric show tech-support l2vpn evpn show tech-support tunnel-ip show tech-support grpc show tech-support appmgr show tech-support netconf show tech-support yserver show tech-support access-lists ipv4 show tech-support access-lists ipv6 show tech-support bcdl show tech-support bundles show tech-support dhcp ipv4 base show tech-support dhcp ipv4 client show tech-support dhcp ipv4 proxy show tech-support dhcp ipv4 relay show tech-support dhcp ipv4 server show tech-support dhcp ipv4 snoop show tech-support dhcp ipv6 base show tech-support dhcp ipv6 client show tech-support dhcp ipv6 proxy show tech-support dhcp ipv6 relay show tech-support dhcp ipv6 server show tech-support flowspec show tech-support ipinfra show tech-support pbr show tech-support placed show tech-support raw show tech-support rsi show tech-support spio show tech-support static show tech-support sysdb show tech-support tcp nsr show tech-support udp show tech-support pfi show tech-support cfgmgr show tech-support tty show tech-support rdsfs
Traffic	Release 7.3.6	show tech-support access-lists ethernet-services show tech-support access-lists ipv4 show tech-support access-lists ipv6 show tech-support aib show tech-support arp show tech-support bcdl show tech-support bcdlv2 show tech-support bfdhwoff show tech-support bundles show tech-support cef show tech-support cef platform show tech-support cfgmgr show tech-support dhcp ipv4 base show tech-support dhcp ipv4 client show tech-support dhcp ipv4 proxy show tech-support dhcp ipv4 relay show tech-support dhcp ipv4 server show tech-support dhcp ipv4 snoop show tech-support dhcp ipv6 base show tech-support dhcp ipv6 client show tech-support dhcp ipv6 proxy show tech-support dhcp ipv6 relay show tech-support dhcp ipv6 server show tech-support ethernet cfm pd show tech-support ethernet interfaces show tech-support ethernet platform show tech-support ethernet protocols oam show tech-support ethernet service-activation-test show tech-support fabric show tech-support flowspec show tech-support grid show tech-support gsp show tech-support ipinfra show tech-support ipv6 nd show tech-support l2rib show tech-support l2vpn show tech-support l2vpn evpn show tech-support l2vpn platform show tech-support lpts show tech-support mirror show tech-support mpls lsd show tech-support mpls oam show tech-support mpls rsvp show tech-support mpls static show tech-support mpls traffic-eng show tech-support netflow show tech-support ofa show tech-support optics show tech-support pbr show tech-support pfi show tech-support placed show tech-support platform-pfc show tech-support protection-notif show tech-support qos pi show tech-support qos platform show tech-support qos tm show tech-support raw show tech-support resmon show tech-support rib show tech-support routing bfd show tech-support rsi show tech-support secy show tech-support segment-routing traffic-eng show tech-support snmp ifmib show tech-support span show tech-support spio show tech-support spp show tech-support static show tech-support statsd show tech-support statsd show tech-support sysdb show tech-support tcp nsr show tech-support tunnel-ip show tech-support udp
System	Release 7.3.6	show tech-support spi show tech-support ofa show tech-support optics show tech-support gsp show tech-support platform timing show tech-support gnss platform show tech-support ptp show tech-support frequency synchronization show tech-support ethernet controllers show tech-support ethernet interfaces show tech-support pfi show tech-support protection-notif show tech-support cfgmgr show tech-support sysdb show tech-support processmgr show tech-support grpc show tech-support telemetry model-driven show tech-support parser show tech-support fabric show tech-support secy show tech-support macsec show tech-support keychain show tech-support kim show tech-support ntp show tech-support placed show tech-support pmengine show tech-support pool show tech-support rdsfs show tech-support resmon show tech-support sdr-invmgr show tech-support sdr-mgbl-proxy show tech-support shmwin show tech-support snmp show tech-support ssh show tech-support system-recovery show tech-support tacacs show tech-support tty show tech-support type6 show tech-support ztp show tech-support alarm-mgr show tech-support cepki show tech-support statsd show tech-support bundles show tech-support snmp ifmib show tech-support ipinfra show tech-support cef show tech-support cef platform show tech-support rsi
Sysadmin	Release 7.3.6	admin show tech-support HBloss admin show tech-support aaa admin show tech-support alarm_mgr admin show tech-support card-mgr admin show tech-support cm admin show tech-support confd admin show tech-support control-ethernet admin show tech-support ctrace admin show tech-support ds admin show tech-support envmon admin show tech-support fabric admin show tech-support fpd admin show tech-support install admin show tech-support obfl admin show tech-support os admin show tech-support pm admin show tech-support sdr_mgr admin show tech-support shelf_mgr admin show tech-support syslog admin show tech-support tacacs-server admin show tech-support tam

Note

This command is not required during normal use of the router.

Task ID


Task ID	Operations
basic-services or cisco-support	read

Examples

The following example shows the output of the show tech-support custom traffic command:

Router# show tech-support custom traffic
++ Show tech start time: 2023-Jun-16.195852.UTC ++
Fri Jun 16 19:58:52 UTC 2023 Waiting for gathering to complete
......................................................................................................................................
Fri Jun 16 20:05:45 UTC 2023 Compressing show tech output
Show tech output available at 0/RP0/CPU0 : /harddisk:/showtech/showtech-custom-traffic-2023-Jun-16.195852.UTC.tgz
++ Show tech end time: 2023-Jun-16.200546.UTC ++

The following example shows the output of the show tech-support custom control-plane command:

Router# show tech-support custom control-plane
++ Show tech start time: 2023-Jun-16.194006.UTC ++
Fri Jun 16 19:40:06 UTC 2023 Waiting for gathering to complete
...............................................................................................
Fri Jun 16 19:44:59 UTC 2023 Compressing show tech output
Show tech output available at 0/RP0/CPU0 : /harddisk:/showtech/showtech-custom-control-2023-Jun-16.194006.UTC.tgz
++ Show tech end time: 2023-Jun-16.194459.UTC ++

The following example shows the output of the show tech-support custom system command:

Router# show tech-support custom system
++ Show tech start time: 2023-Jun-16.194549.UTC ++
Fri Jun 16 19:45:50 UTC 2023 Waiting for gathering to complete
.......................................................................................................................................................................
Fri Jun 16 19:54:24 UTC 2023 Compressing show tech output
Show tech output available at 0/RP0/CPU0 : /harddisk:/showtech/showtech-custom-system-2023-Jun-16.194549.UTC.tgz
++ Show tech end time: 2023-Jun-16.195425.UTC ++

The following example shows the output of the show tech-support custom sysadmin command:

Router# show tech-support custom sysadmin
Thu Jan 11 17:45:46.429 PST
++ Show tech start time: 2024-Jan-11.174606.PST ++
Thu Jan 11 17:46:07 PST 2024 Waiting for gathering to complete
.Thu Jan 11 17:46:10 PST 2024 Waiting for Sysadmin show tech-support collection
..................................Thu Jan 11 18:17:11 PST 2024 Please collect Admin show tech-support ctrace in addition to any sysadmin show-tech-support collection
 
Thu Jan 11 18:17:11 PST 2024 Compressing show tech output
Show tech output available at 0/RP0/CPU0 : /harddisk:/showtech/showtech-F9-custom-sys-admin-2024-Jan-11.174606.PST.tgz
++ Show tech end time: 2024-Jan-11.181723.PST ++

show tech-support mgbl

To collect the logs or traces for gRPC module, Network Configuration Protocol (NETCONF) module, and telemetry, use the show tech-support mgbl command in the XR EXEC mode.

show tech-support mgbl {file | grpc | list-CLIs | location | netconf | rack | telemetry | time-out}

Syntax Description


mgbl	Executes the commands for manageability components.
file	Specifies a file name with or without a file path where the output is stored. You can either specify the filename or the path of the file. To specify only the name of the file, use this command: show tech-support mgbl file `filename` To specify the file path, use this command: show tech-support mgbl file `filepath` Valid file path options are: apphost: `filename` config: `filename` disk0: `filename` ftp: `filename` harddisk: `filename` rootfs: `filename` tftp: `filename`
grpc	Collects the logs or traces for gRPC module.
list-CLIs	Lists the CLIs related to the manageability components.
location	Specifies the node location.
netconf	Collects the logs or traces for Network Configuration Protocol (NETCONF) module.
rack	Specifies the rack (0/1/2).
telemetry	Collects the logs or traces for telemetry.
time-out	Specifies the timeout configuration for each show command in seconds. The default value is 900 seconds and its ranges between 120-3600 seconds.

Command Default

The command output is compressed.
The command does not support location-based collection.

Command Modes

XR EXEC mode

Command History


Release	Modification
Release 24.1.1	This command was introduced.

Usage Guidelines

This command generates tech-support information that is useful for Cisco Technical Support representatives when troubleshooting a router. By default, the output of this command is saved on the router's hard disk in a file with .tgz extension. You can share this file with Cisco Technical Support. To share, use the copy command to copy the .tgz file to a server or local machine. For example, copy harddisk:/showtech/ name.tgz tftp:// server_path.

For Cisco Technical Support contact information, see the 'Obtaining Documentation and Submitting a Service Request' section in the Preface.

Task ID


Task ID	Operations
cisco-support	read

Examples

This example shows the output of the show tech-support mgbl command.

RP/0/RP0/CPU0:R0#show tech-support mgbl ?
  file       Specify a valid file name (e.g. disk0:tmp.log)
  grpc       Collect showtech for grpc(cisco-support)
  list-CLIs  list the commands that would be run (don't execute)(cisco-support)
  location   Specify a location(cisco-support)
  netconf    Collect showtech for netconf(cisco-support)
  rack       Specify a rack(cisco-support)
  telemetry  Collect showtech for telemetry(cisco-support)
  time-out   per show command timeout configuration(cisco-support)
  <cr>

Note

The show tech-support mgbl command does not support location-based collection.

RP/0/RP0/CPU0:R0#show tech-support mgbl location 0/RP0/CPU0
Mon Feb 19 02:37:03.652 UTC
++ Show tech start time: 2024-Feb-19.023703.UTC ++
This show tech-support doesn't support location based collection. Exiting.
++ Show tech end time: 2024-Feb-19.023703.UTC ++

show tech-support mgbl grpc

To collect the logs or traces for gRPC module, use the show tech-support mgbl grpc command in the XR EXEC mode.

show tech-support mgbl grpc file {filename | filepath}

Syntax Description


mgbl	Executes the commands for manageability components.
grpc	Collects the logs or traces for gRPC module.
file	Specifies a file name with or without a file path where the output is stored.
`filename`	Specifies the name of the file. show tech-support mgbl grpc file `filename`
`filepath`	Specifies the file path with the file name. show tech-support mgbl grpc file `filepath` Valid file path options are: apphost: `filename` config: `filename` disk0: `filename` ftp: `filename` harddisk: `filename` rootfs: `filename` tftp: `filename`

Command Default

The command output is compressed.
The command does not support location-based collection.

Command Modes

XR EXEC mode

Command History


Release	Modification
Release 24.1.1	This command was introduced.

Usage Guidelines

This command generates tech-support information that is useful for Cisco Technical Support representatives when troubleshooting a router. By default, the output of this command is saved on the router's hard disk in a file with .tgz extension. You can share this file with Cisco Technical Support. To share, use the copy command to copy the .tgz file to a server or local machine. For example, copy harddisk:/showtech/ name.tgz tftp:// server_path.

For Cisco Technical Support contact information, see the 'Obtaining Documentation and Submitting a Service Request' section in the Preface.

Task ID


Task ID	Operations
cisco-support	read

Examples

This example shows the output of the show tech-support mgbl grpc file command.

RP/0/RP0/CPU0:R0#show tech-support mgbl grpc file disk0:tmp.log
Fri Feb  2 06:12:15.098 UTC
++ Show tech start time: 2024-Feb-02.061215.UTC ++
Fri Feb  2 06:12:16 UTC 2024 Waiting for gathering to complete
............
Fri Feb  2 06:12:53 UTC 2024 Compressing show tech output
Show tech output available at 0/RP0/CPU0 : /disk0:/tmp.log.tgz
++ Show tech end time: 2024-Feb-02.061254.UTC ++

Note

The show tech-support mgbl grpc command does not support location-based collection.

RP/0/RP0/CPU0:R0#show tech-support mgbl grpc location 0/RP0/CPU0
Fri Feb  2 06:13:34.590 UTC
++ Show tech start time: 2024-Feb-02.061334.UTC ++
This show tech-support doesn't support location based collection. Exiting.
++ Show tech end time: 2024-Feb-02.061335.UTC ++

show tech-support mgbl netconf

To collect the logs or traces for Network Configuration Protocol (NETCONF) module, use the show tech-support mgbl netconf command in the XR EXEC mode.

show tech-support mgbl netconf file {filename | filepath}

Syntax Description


mgbl	Executes the commands for manageability components.
netconf	Collects the logs or traces for Network Configuration Protocol (NETCONF) module.
file	Specifies a file name with or without a file path where the output is stored.
`filename`	Specifies the name of the file. show tech-support mgbl netconf file `filename`
`filepath`	Specifies the file path with the file name. show tech-support mgbl netconf file `filepath` Valid file path options are: apphost: `filename` config: `filename` disk0: `filename` ftp: `filename` harddisk: `filename` rootfs: `filename` tftp: `filename`

Command Default

The command output is compressed.
The command does not support location-based collection.

Command Modes

XR EXEC mode

Command History


Release	Modification
Release 24.1.1	This command was introduced.

Usage Guidelines

This command generates tech-support information that is useful for Cisco Technical Support representatives when troubleshooting a router. By default, the output of this command is saved on the router's hard disk in a file with .tgz extension. You can share this file with Cisco Technical Support. To share, use the copy command to copy the .tgz file to a server or local machine. For example, copy harddisk:/showtech/ name.tgz tftp:// server_path.

For Cisco Technical Support contact information, see the 'Obtaining Documentation and Submitting a Service Request' section in the Preface.

Task ID


Task ID	Operations
cisco-support	read

Examples

This example shows the output of the show tech-support mgbl netconf file command.

RP/0/RP0/CPU0:R0#show tech-support mgbl netconf file disk0:tmp.log
Fri Feb  2 06:12:15.098 UTC
++ Show tech start time: 2024-Feb-02.061215.UTC ++
Fri Feb  2 06:12:16 UTC 2024 Waiting for gathering to complete
............
Fri Feb  2 06:12:53 UTC 2024 Compressing show tech output
Show tech output available at 0/RP0/CPU0 : /disk0:/tmp.log.tgz
++ Show tech end time: 2024-Feb-02.061254.UTC ++

Note

The show tech-support mgbl netconf command does not support location-based collection.

RP/0/RP0/CPU0:R0#show tech-support mgbl netconf location 0/RP0/CPU0
Fri Feb  2 06:13:34.590 UTC
++ Show tech start time: 2024-Feb-02.061334.UTC ++
This show tech-support doesn't support location based collection. Exiting.
++ Show tech end time: 2024-Feb-02.061335.UTC ++

show tech-support mgbl telemetry

To collect the logs or traces for telemetry, use the show tech-support mgbl telemetry command in the XR EXEC mode.

show tech-support mgbl telemetry file {filename | filepath}

Syntax Description


mgbl	Executes the commands for manageability components.
telemetry	Collects the logs or traces for telemetry.
file	Specifies a file name with or without a file path where the output is stored.
`filename`	Specifies the name of the file. show tech-support mgbl telemetry file `filename`
`filepath`	Specifies the file path with the file name. show tech-support mgbl telemetry file `filepath` Valid file path options are: apphost: `filename` config: `filename` disk0: `filename` ftp: `filename` harddisk: `filename` rootfs: `filename` tftp: `filename`

Command Default

The command output is compressed.
The command does not support location-based collection.

Command Modes

XR EXEC mode

Command History


Release	Modification
Release 24.1.1	This command was introduced.

Usage Guidelines

This command generates tech-support information that is useful for Cisco Technical Support representatives when troubleshooting a router. By default, the output of this command is saved on the router's hard disk in a file with .tgz extension. You can share this file with Cisco Technical Support. To share, use the copy command to copy the .tgz file to a server or local machine. For example, copy harddisk:/showtech/ name.tgz tftp:// server_path.

For Cisco Technical Support contact information, see the 'Obtaining Documentation and Submitting a Service Request' section in the Preface.

Task ID


Task ID	Operations
cisco-support	read

Examples

This example shows the output of the show tech-support mgbl telemetry file command.

RP/0/RP0/CPU0:R0#show tech-support mgbl telemetry file disk0:tmp.log
Fri Feb  2 06:12:15.098 UTC
++ Show tech start time: 2024-Feb-02.061215.UTC ++
Fri Feb  2 06:12:16 UTC 2024 Waiting for gathering to complete
............
Fri Feb  2 06:12:53 UTC 2024 Compressing show tech output
Show tech output available at 0/RP0/CPU0 : /disk0:/tmp.log.tgz
++ Show tech end time: 2024-Feb-02.061254.UTC ++

Note

The show tech-support mgbl telemetry command does not support location-based collection.

RP/0/RP0/CPU0:R0#show tech-support mgbl telemetry location 0/RP0/CPU0
Fri Feb  2 06:13:34.590 UTC
++ Show tech start time: 2024-Feb-02.061334.UTC ++
This show tech-support doesn't support location based collection. Exiting.
++ Show tech end time: 2024-Feb-02.061335.UTC ++

Bias-Free Language

Results

Chapter: Tech-Support Commands

Tech-Support Commands

show tech-support custom

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

show tech-support mgbl

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

show tech-support mgbl grpc

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

show tech-support mgbl netconf

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

show tech-support mgbl telemetry

Syntax Description

Command Default

Command Modes

Command History

Usage Guidelines

Task ID

Examples

Was this Document Helpful?

Contact Cisco