Skip to content

docs(troubleshooting): diagnostic walkthrough for down fiber links#298

Open
pau-hedgehog wants to merge 1 commit intomasterfrom
pau/tshoot-fiber
Open

docs(troubleshooting): diagnostic walkthrough for down fiber links#298
pau-hedgehog wants to merge 1 commit intomasterfrom
pau/tshoot-fiber

Conversation

@pau-hedgehog
Copy link
Copy Markdown
Contributor

Adds a step-by-step procedure that takes a user from a kubectl fabric inspect lldp/bgp failure to a narrowed layer 1 root cause using only the inspect surface (--ports, --lasers), including interpretation of common per-lane optical power patterns on 800G DR8.

@pau-hedgehog pau-hedgehog self-assigned this Apr 24, 2026
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 24, 2026

🚀 Deployed on https://preview-298--hedgehog-docs.netlify.app

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a troubleshooting walkthrough to help operators diagnose physical (Layer 1) causes of down fiber links using kubectl fabric inspect, focusing on interpreting per-lane laser power patterns (notably for 800GBASE-DR8).

Changes:

  • Documented a step-by-step workflow starting from LLDP/BGP neighbor failures to isolating a single problematic link/port.
  • Added guidance on using inspect switch --ports and inspect switch --lasers for diagnosis.
  • Included interpretation patterns for per-lane optical power readings on 800G DR8.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/troubleshooting/physical_links.md Outdated
Comment thread docs/troubleshooting/physical_links.md Outdated
@pau-hedgehog pau-hedgehog force-pushed the pau/tshoot-fiber branch 2 times, most recently from bd62d37 to f568471 Compare April 24, 2026 14:26
Adds a step-by-step procedure that takes a user from a kubectl fabric
inspect lldp/bgp failure to a narrowed layer 1 root cause using only
the inspect surface (--ports, --lasers), including interpretation of
common per-lane optical power patterns on 800G DR8.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Signed-off-by: Pau Capdevila <pau@githedgehog.com>
@pau-hedgehog pau-hedgehog marked this pull request as ready for review April 24, 2026 14:53
@pau-hedgehog pau-hedgehog requested a review from a team as a code owner April 24, 2026 14:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants