โ† Back to skills
extension
Category: Development & EngineeringNo API key required

Device Inspection

Execute comprehensive L1-L4 network device inspection. Use when user asks to "inspect all devices", "run comprehensive health check", "full network audit", or needs systematic L1-L4 analysis across multiple devices.

personAuthor: jakexiaohubgithub

Device Inspection - Comprehensive L1-L4

Applicable Scenarios

  • Comprehensive network health assessment (all test devices)
  • Full stack network inspection (L1-L4)
  • Network baseline establishment and verification
  • Pre-maintenance complete audit

Identification Signals

User questions contain: "inspect", "comprehensive", "full check", "all devices", "L1-L4"

Execution Strategy

  1. List all devices in 'test' group using list_devices(group="test")
  2. For each device, execute comprehensive inspection covering L1 (Physical), L2 (Data Link), L3 (Network), L4 (Transport)
  3. Generate consolidated report with device-by-device status
  4. Flag anomalies across all layers

Comprehensive Inspection Template (L1-L4)

L1 - Physical Layer

  • [ ] show version (Device model, serial, uptime)
  • [ ] show inventory (Hardware modules, power supplies, fans)
  • [ ] show environment all (Temperature, power status, fan status)
  • [ ] show interfaces (Physical port states, media types)

L2 - Data Link Layer

  • [ ] show vlan brief (VLAN configuration and status)
  • [ ] show spanning-tree summary (STP topology, root bridge)
  • [ ] show spanning-tree detail (Port states, costs)
  • [ ] show cdp neighbors (CDP neighbor discovery)
  • [ ] show mac address-table (MAC table status, count)

L3 - Network Layer

  • [ ] show ip route summary (Route count and protocol summary)
  • [ ] show ip ospf neighbor (OSPF neighbor status)
  • [ ] show ip ospf interface brief (OSPF interface states)
  • [ ] show ip bgp summary (BGP neighbor status)
  • [ ] show ip bgp vpnv4 all summary (VPNv4 status if applicable)

L4 - Transport Layer & Services

  • [ ] show tcp brief (TCP session count)
  • [ ] show processes cpu (CPU utilization and process breakdown)
  • [ ] show memory statistics (Memory usage across memory pools)
  • [ ] show interfaces counters errors (Error counters on all interfaces)
  • [ ] show interfaces counters dropped (Dropped packet counters)

Report Format

Executive Summary

๐Ÿ“‹ test Network Comprehensive Inspection Report
Inspection Time: 2026-01-08 14:30:00
Total Devices: 8
Overall Status: 2 devices OK, 5 devices WARNING, 1 device CRITICAL

Device Summary:
โ”œโ”€ R1 (10.1.1.1) โœ… OK - L1:โœ… L2:โœ… L3:โœ… L4:โœ…
โ”œโ”€ R2 (10.1.1.2) โš ๏ธ WARNING - L1:โš ๏ธ L2:โœ… L3:โœ… L4:โœ…
โ”œโ”€ R3 (10.1.1.3) โš ๏ธ WARNING - L1:โœ… L2:โœ… L3:โœ… L4:โš ๏ธ
โ”œโ”€ R4 (10.1.1.4) โš ๏ธ WARNING - L1:โš ๏ธ L2:โœ… L3:โœ… L4:โœ…
โ”œโ”€ S1 (10.2.1.1) โœ… OK - L1:โœ… L2:โœ… L3:โœ… L4:โœ…
โ”œโ”€ S2 (10.2.1.2) โš ๏ธ WARNING - L1:โœ… L2:โš ๏ธ L3:โœ… L4:โœ…
โ”œโ”€ A1 (10.3.1.1) โš ๏ธ WARNING - L1:โœ… L2:โœ… L3:โš ๏ธ L4:โœ…
โ””โ”€ A2 (10.3.1.2) โŒ CRITICAL - L1:โŒ L2:โœ… L3:โœ… L4:โš ๏ธ

Device-by-Device Detailed Results

Each device gets a full L1-L4 report:

โ•”โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•—
โ•‘ Device: R1 (10.1.1.1) - Core Router                 โ•‘
โ•‘ Platform: Cisco IOS XE                              โ•‘
โ•‘ Status: โœ… ALL SYSTEMS OK                           โ•‘
โ•šโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•

Layer 1 (Physical):
  CPU Utilization: 15% (5min avg) โœ…
  Memory Usage: 62% (avaitestle: 8.2GB) โœ…
  Temperature: 42ยฐC (threshold: 70ยฐC) โœ…
  Power Supplies: 2/2 ACTIVE โœ…
  Fans: 6/6 SPINNING โœ…

Layer 2 (Data Link):
  VLAN Count: 45 โœ…
  Active Ports: 48/48 UP โœ…
  STP Root: YES (Priority: 24576) โœ…
  LLDP Neighbors: 4 discovered โœ…

Layer 3 (Network):
  IPv4 Routes: 2,847 routes โœ…
  OSPF Neighbors: 3 FULL โœ…
  BGP Neighbors: 2 ESTABLISHED โœ…
  Routing Errors: 0 โœ…

Layer 4 (Transport):
  Interface Errors: 0 (24h avg) โœ…
  Dropped Packets: 0 (24h avg) โœ…
  TCP Sessions: 45 active โœ…
  UDP Flows: 128 active โœ…

Anomaly Details & Recommendations

โš ๏ธ WARNING: R2 - Temperature trending high
Current: 58ยฐC | Trend: +2ยฐC/hour | Threshold: 70ยฐC
Recommendation: Monitor closely, ensure adequate airflow

โŒ CRITICAL: A2 - Power supply #1 degraded
Status: FAILED | Uptime before failure: 847 days
Recommendation: Replace PSU immediately before other PSU fails

Consolidated Findings

Critical Issues (Immediate Action):
1. A2 Power Supply Failure - Replace PSU
2. A1 BGP Neighbor Flapping - Check link stability

Warnings (Monitor):
1. R2 Temperature trending up - Check cooling
2. S2 STP Bridge Priority - May need rebalancing
3. R3 Interface FCS Errors increasing - Check optics

Informational (Good Status):
- All core devices operating normally
- test network stable and well-managed

Multi-Device Inspection Process

  1. Device Collection: Query all devices in 'test' group
  2. Parallel Execution: Execute inspection template on each device
  3. Data Aggregation: Collect and normalize results
  4. Analysis: Compare against health baselines
  5. Reporting: Generate comprehensive multi-device report with:
    • Overall network health score
    • Device-by-device status
    • Cross-layer dependency analysis
    • Consolidated recommendations

Output Artifact

reports/test-comprehensive-inspection-20260108-143000.md
โ”œโ”€ Executive Summary Dashboard
โ”œโ”€ Device Status Matrix
โ”œโ”€ Layer-by-Layer Details (8 devices ร— 4 layers = 32 sections)
โ”œโ”€ Anomaly Analysis
โ”œโ”€ Historical Comparison (vs. previous inspection)
โ””โ”€ Recommendations & Actions