Field Guide

WireGuard tunnels blackhole traffic due overlapping route advertisements.

Use this to find route precedence conflicts, peer policy mismatch, and split-tunnel drift across sites.

What this issue pattern usually means.

This issue usually indicates drift in route selection, peer ACLs, and tunnel path determinism. The objective is to separate symptom visibility from true root cause so containment and correction happen in the right order.

Confirm dependency and control-path assumptions first.

  • Confirm current scope in Site-to-site WireGuard networks and identify exactly which workloads or users are failing.
  • Validate recent changes affecting route selection, peer ACLs, and tunnel path determinism, including policy updates, patching, certificates, or routing.
  • Compare healthy and failing paths to identify the first point where behavior diverges.
  • Check logs and telemetry for correlated warnings during the same failure window.
  • Capture evidence before rollback so permanent remediation can be implemented later.

Recover service quickly without creating hidden debt.

  • Reproduce with a scoped test while collecting timestamped evidence.
  • Restore minimal known-good path for critical traffic first.
  • Validate service behavior from multiple clients or nodes after correction.
  • Apply durable fix for route selection, peer ACLs, and tunnel path determinism and remove temporary exceptions.
  • Document break condition, detection signal, and prevention controls for recurrence.