cisco-ios-router-troubleshooting

Diagnose Cisco IOS router issues from support bundles, logs, configs, and show command output.

1|Updated Jan 18, 2024
One-click install
npx skills add https://github.com/brockners/ciscolive --skill cisco-ios-router-troubleshooting-brockners
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cisco-ios-router-troubleshooting
Source: https://github.com/brockners/ciscolive/tree/main/CLUS26/EXP9/skills/cisco-ios-router-troubleshooting
Command: npx skills add https://github.com/brockners/ciscolive --skill cisco-ios-router-troubleshooting-brockners

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Analyzing Cisco IOS router support bundles, syslog streams, and show tech output is slow and error-prone, especially when correlating config changes, interface events, and routing protocol behavior across large evidence files. ## Core Features & Use Cases - Evidence-Driven Analysis: Classifies and inventories tarballs, syslog/debug logs, running configs, crashinfo, interface counters, and packet captures before deep analysis. - Hypothesis-Driven Root Cause: Maintains competing hypotheses with supporting and refuting evidence, covering OSPF, EIGRP, BGP, interfaces, ACL/NAT, CPU/memory, and reloads. - Timeline Correlation: Builds a unified timeline of config changes, adjacency flaps, reachability failures, and tracebacks with cited file paths and line numbers. - Use Case: Given a TAC support bundle where OSPF neighbors keep dropping, extract the archive, correlate %SYS-5-CONFIG_I change markers with dead timer expirations, and produce a root-cause report with cited evidence. ## Quick Start Use the cisco-ios-router-troubleshooting skill to analyze the uploaded router support bundle and produce a hypothesis-driven root-cause analysis with cited evidence.

Frequently Asked Questions about cisco-ios-router-troubleshooting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot a Cisco IOS router from a support bundle?▼

Extract the tarball into scratch space, inventory logs, configs, and show outputs, then run broad keyword searches for tracebacks, LINK/LINEPROTO events, and routing protocol messages. Correlate findings across logs, state, and config before forming hypotheses.

How to find the root cause of OSPF neighbor flapping on Cisco routers?▼

Check the neighbor down reason first: dead timer expired points to lost Hellos from link loss, congestion, filtering, or CPU starvation, while interface down points to local state. Verify timers, network type, MTU, authentication, and correlate with interface counters and config changes.

What tools parse Cisco show command output?▼

Cisco pyATS/Genie parsers handle structured parsing of supported show commands, while TextFSM with ntc-templates covers outputs Genie misses. For configuration queries, ciscoconfparse works well, and raw text remains the source of truth if a parser fails.

Does a %SYS-5-CONFIG_I syslog message indicate a failure?▼

No, %SYS-5-CONFIG_I is a configuration change marker, not a failure. Treat it as a timeline anchor and correlate it with nearby adjacency or interface events and archive config diffs to test a change-induced outage hypothesis.

Why is my Cisco router debug log too large to analyze?▼

IOS debug output often dominates bundles with repetitive per-packet lines. Collapse repeated flows by source, destination, interface, and time range, then prioritize unusual outcomes like unroutable, encapsulation failed, ACL denies, or missing reverse traffic.

When is a traceback evidence of a Cisco software defect?▼

A traceback indicates a possible software defect only when corroborated by IOS version, reload reason, matching crashinfo, recurrence, and timing aligned with the symptoms. An isolated traceback outside the symptom window should not be called the root cause.