Skip to content

docs(vlab): explain how to read test-connectivity output#302

Merged
Frostman merged 1 commit intomasterfrom
pau/test-connectivity-gap
Apr 30, 2026
Merged

docs(vlab): explain how to read test-connectivity output#302
Frostman merged 1 commit intomasterfrom
pau/test-connectivity-gap

Conversation

@pau-hedgehog
Copy link
Copy Markdown
Contributor

@pau-hedgehog pau-hedgehog commented Apr 29, 2026

The Test Connectivity section in vlab/demo.md only showed the --help output. Newcomers to the tool repeatedly mis-read the per-pair logs: they see lines reporting "100% packet loss" or "connection refused", assume the fabric is broken, and miss that the test was deliberately checking that those pairs cannot reach each other.

Add a short "How to read the output" subsection that:

  • frames the tool as comparing observed behaviour against the configured policy, not just running pings
  • gives the four expected/observed combinations as a table, with the surprising "should not be reachable + probe fails = pass" row called out so it doesn't trip up readers

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

github-actions Bot commented Apr 29, 2026

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

@pau-hedgehog pau-hedgehog force-pushed the pau/test-connectivity-gap branch 7 times, most recently from 7537dcf to 6070374 Compare April 29, 2026 15:47
The Test Connectivity section in vlab/demo.md only showed the --help
output. Newcomers to the tool repeatedly mis-read the per-pair logs:
they see lines reporting "100% packet loss" or "connection refused",
assume the fabric is broken, and miss that the test was deliberately
checking that those pairs cannot reach each other.

Add a short "How to read the output" subsection that:
- frames the tool as comparing observed behaviour against the
  configured policy, not just running pings
- gives the four expected/observed combinations as a table, with the
  surprising "should not be reachable + probe fails = pass" row
  called out so it doesn't trip up readers
- points at the expected=true / expected=false fields in the per-pair
  log line so a single line can be interpreted on its own
- nudges users toward the runner's summary instead of grepping
  through individual probe results

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Signed-off-by: Pau Capdevila <pau@githedgehog.com>
@pau-hedgehog pau-hedgehog force-pushed the pau/test-connectivity-gap branch from 6070374 to 49f8ff3 Compare April 29, 2026 15:51
@pau-hedgehog pau-hedgehog marked this pull request as ready for review April 29, 2026 15:57
@pau-hedgehog pau-hedgehog requested a review from a team as a code owner April 29, 2026 15:57
@Frostman Frostman merged commit 22b4c81 into master Apr 30, 2026
4 checks passed
@Frostman Frostman deleted the pau/test-connectivity-gap branch April 30, 2026 01:20
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