Technologies/Tailscale/tailscale.node.latency
TailscaleTailscaleMetric

tailscale.node.latency

Peer latency milliseconds
Dimensions:None
Available on:Google Cloud MonitoringGoogle Cloud Monitoring (1)

Summary

Network round-trip time (RTT) between this node and a specific peer, typically measured in milliseconds. This gauge tracks connection quality and path performance. Elevated latency indicates network path degradation, routing through distant DERP relays, or congestion. Sudden increases may signal path changes or network issues requiring investigation. Critical for diagnosing performance problems and validating direct peer connectivity.

Interface Metrics (1)
Google Cloud MonitoringGoogle Cloud Monitoring
Network latency in milliseconds from this node to peer nodes
Dimensions:None

Technical Annotations (79)

Configuration Parameters (9)
ethtool.udp_throughputrecommended: enabled
Required for UDP throughput optimization on Linux kernel 6.2
Retriesrecommended: 0
Zero retries for immediate alerting on connectivity loss
Packet Sizerecommended: 57
ICMP packet size for ping monitor
DERP_ADDRrecommended: :3443
Custom port binding when default port 443 is blocked
DERPPortrecommended: 3443
Must match DERP_ADDR port in ACL derpMap configuration
OmitDefaultRegionsrecommended: false
Recommended to retain default DERP fallback for high availability
derpMap.regions.RegionIDrecommended: null
Setting to null disables the specified DERP region
--portrecommended: 41641
Default UDP port for direct connections; can be changed via tailscaled --port=<number>
/etc/defaults/tailscaledrecommended: port configuration
Linux location to set custom port for tailscaled
Error Signatures (3)
relay "code"log pattern
direct connection not establishedlog pattern
via DERP(log pattern
CLI Commands (21)
tailscale up --accept-routes --exit-node=my-vps-exit-noderemediation
tailscale statusdiagnostic
ip routediagnostic
tailscale pingdiagnostic
tailscale ping <device>diagnostic
pingdiagnostic
ifconfigdiagnostic
traceroutediagnostic
tailscale netcheckdiagnostic
tailscale versiondiagnostic
iperf3 -c serverdiagnostic
iperf3 --udp --bitrate 200M -c server -Rdiagnostic
mtr serverdiagnostic
rsync -ah --progress /radarr-pool/Tenet\ \(2020\)/Tenet\ \(2020\)\ Bluray-2160p.mkv ~/Downloadsdiagnostic
scp -C ashayc@<redacted>:/radarr-pool/Tenet\ \(2020\)/Tenet\ \(2020\)\ Bluray-2160p.mkv ~/Downloadsdiagnostic
tailscale ping 100.64.10.99diagnostic
curl -Iv https://derp.example.com:3443diagnostic
tailscale ping <node>diagnostic
curl https://controlplane.tailscale.com/derpmap/defaultdiagnostic
curl --silent https://controlplane.tailscale.com/derpmap/default | jq -r '.Regions[] | "\(.RegionID) \(.RegionName)"'diagnostic
tailscale ping <device-name>diagnostic
Technical References (46)
0.0.0.0/0conceptsubnet routescomponentexit nodecomponenthome DERP serverconceptcoordination servercomponentHard NATconceptDERPcomponenthead-of-line blockingconceptTCP meltdownconceptsubnet routercomponentrelay servercomponentMTRcomponentWiresharkcomponentNICcomponentNAT traversalconcepttailnetconcepttailscaled daemoncomponentdirect connectionconceptaccess control policiesconceptiperf3componentethtoolcomponentDERP relaycomponentJellyfincomponentLinux kernel 6.2componentMTUconceptUDPprotocolWireGuardprotocolport 41641conceptMappingVariesByDestIPcomponentderpMapcomponentTailscale Admin ConsolecomponentOmitDefaultRegionscomponentsymmetric NATconceptCGNATconceptDERP server selectionconcepttailnet policy filefile pathRegionIDconceptDERP servercomponentNAT-PMPprotocolUPnPprotocolQoSconceptpeer relaycomponentNATcomponenthard NATconceptDERP relay serverscomponentPCPprotocol
Related Insights (35)
Exit node default route overrides subnet routes causing connection failurescritical
DERP region outage triggers automatic failover to alternative regionsinfo
Hard NAT causes slow connections and DNS timeouts via DERP relaywarning
DERP relay usage detected instead of direct connectionsinfo
High latency or packet loss on internet connections through tailnetwarning
High latency or packet loss between tailnet peerswarning
Network latency or packet loss indicates connectivity degradationwarning
DERP relay fallback degrades performance when direct connection failswarning
Outdated Tailscale client versions cause unstable connections and performance degradationwarning
Exit node performance issues or access restrictions prevent internet connectivitywarning
TCP throughput degradation on long-distance connections despite adequate UDP performancewarning
Exit node routing causes extreme latency increase and bandwidth collapsecritical
Media server streaming bottleneck from inadequate throughput between distant peerswarning
SCP transfers over Tailscale achieve only 0.5-1.5 Mbps despite direct connection and sufficient bandwidthwarning
Relayed connections reduce network performancewarning
Ping monitor failure indicates network connectivity losscritical
Traffic relays through DERP instead of direct peer connection causing latencywarning
UDP connectivity blocked prevents direct WireGuard connections forcing DERP relaywarning
Direct connection failure between home peers despite no restrictive NATwarning
DERP custom port requires explicit DERPPort configuration in ACLcritical
OmitDefaultRegions=true leaves no DERP fallback if custom node failswarning
Symmetric NAT prevents direct peer connections forcing DERP relay fallbackwarning
High latency and jitter on DERP relay indicates suboptimal routing pathinfo
DERP relay connections indicate direct connection failure or suboptimal routingwarning
Disabling DERP regions via policy file affects connection availabilitywarning
Relayed connection when direct is possible causes performance degradationwarning
Blocked UDP packets force fallback to relayed connectionswarning
Direct connection degradation during NAT traversal negotiationinfo
Peer relay provides better performance than DERP for blocked direct connectionsinfo
Connection type changes when network conditions deterioratewarning
Hard NAT on both sides forces DERP relay connection degrading performancewarning
Packet loss on peer connections indicating network instabilitywarning

Packet loss between peers indicates network path instability, congestion, or hardware issues. Even small amounts of packet loss (>1%) can severely impact TCP throughput and latency-sensitive applications, causing retransmissions, increased latency, and degraded user experience.

Excessive traffic through exit node indicating performance bottleneckwarning

When a large volume of traffic is routed through a single exit node, it can create a performance bottleneck, saturating the exit node's bandwidth, CPU, or network interfaces. This degrades performance for all users routing through that exit node and creates a single point of failure.

DERP relay dependency indicating direct connectivity failurewarning

When peer connections are forced to route through DERP relay servers instead of establishing direct peer-to-peer connections, this indicates NAT traversal failures, firewall restrictions, or network configuration issues. DERP relays add latency and consume additional bandwidth, degrading performance and increasing infrastructure costs.

Elevated peer latency indicating network path degradationwarning

Sustained increases in peer-to-peer latency indicate network path degradation, increased reliance on DERP relays, or intermediate network congestion. This directly impacts application performance for latency-sensitive workloads and user experience.