warp-diag
Diagnose and troubleshoot Cloudflare Warp client issues
TLDR
Generate a Zip file with information about the system configuration and the WARP connection
Generate a Zip file with debug information including a timestamp to the output filename
Save the output file under a specific directory
Submit a new feedback to Cloudflare's WARP interactively
SYNOPSIS
`warp-diag [command] [options]
or
sudo warp-diag [command] [options]
PARAMETERS
debug
Collects and prints detailed diagnostic information to standard output.
upload
Collects diagnostic information and securely uploads it to Cloudflare's support system, providing a unique reference ID for tracking.
--help
Displays the command's usage instructions and available options.
--version
Shows the installed version of the Cloudflare WARP client.
DESCRIPTION
`warp-diag` is a command-line utility bundled with the Cloudflare WARP client. Its primary function is to collect comprehensive diagnostic logs and system-specific information crucial for troubleshooting issues related to the WARP service.
This data helps users and Cloudflare support teams pinpoint the root cause of connectivity problems, performance degradation, or other malfunctions experienced while using WARP, providing a snapshot of the client's operational state, network configuration, and relevant system logs.
CAVEATS
Requires the Cloudflare WARP client to be installed and running.
Often requires sudo privileges to collect comprehensive system and network data.
The upload command sends system and network diagnostic information to Cloudflare; users should be aware of potential privacy implications, though Cloudflare states data is used for troubleshooting only.
OUTPUT DESTINATION
When using the `debug` command, output is printed directly to your terminal. For the `upload` command, a unique reference ID is displayed upon successful upload, which can be shared with Cloudflare support. Local log files for the WARP client are typically found in directories like /var/log/cloudflare-warp/ on Linux systems.
TROUBLESHOOTING AID
`warp-diag` is primarily a support tool. Its output is often technical and intended to be analyzed by network professionals or Cloudflare's support team to diagnose complex connectivity or performance problems with the WARP service.
HISTORY
Cloudflare launched its WARP service, a secure DNS resolver and VPN-like product, in 2019. As the service gained adoption, the need for robust diagnostic tools became apparent to assist users in troubleshooting network and connectivity issues, leading to the development and inclusion of `warp-diag` as a vital utility within the WARP client package.