LinuxCommandLibrary

warp-diag

Diagnose and troubleshoot Cloudflare Warp client issues

TLDR

Generate a Zip file with information about the system configuration and the WARP connection

$ warp-diag
copy

Generate a Zip file with debug information including a timestamp to the output filename
$ warp-diag --add-ts
copy

Save the output file under a specific directory
$ warp-diag --output [path/to/directory]
copy

Submit a new feedback to Cloudflare's WARP interactively
$ warp-diag feedback
copy

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.

SEE ALSO

warp-cli(1), ping(8), ip(8), ss(8)

Copied to clipboard