[CF1] warp troubleshooting #23956
[CF1] warp troubleshooting #23956
Conversation
|
This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:
|
...cs/cloudflare-one/connections/connect-devices/warp/troubleshooting/troubleshooting-guide.mdx
Show resolved
Hide resolved
| :::tip[Include scenario, timestamps, and steps taken to troubleshoot the issue] | ||
| Refer to the following example of an ideal ticket description: | ||
|
|
||
| Karen was on a train on July 17, 2025, at approximately 1:00 PM Central Time. She attempted to connect to a captive portal but received the following error message in Chrome: `error_message_details`. A warp diag was collected immediately after and is attached. |
There was a problem hiding this comment.
I'm not sure if error_message_details is a "real" error message? I would suspect something like ERR_CONNECTION_RESET or ERR_TOO_MANY_REDIRECTS are what the user might see in this scenario.
|
|
||
| ### Option B: Collect logs via the CLI | ||
|
|
||
| Collect WARP diagnostic logs by downloading them to your desktop using the `warp-diag` CLI. |
There was a problem hiding this comment.
Let's consider a different word than "downloading" since warp-diag is generating the content itself locally on the machine rather than contacting Cloudflare services and downloading anything from there.
| | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ||
| | **Service / Daemon** | `C:\Program Files\Cloudflare\Cloudflare WARP\warp-svc.exe` | | ||
| | **GUI application** | `C:\Program Files\Cloudflare\Cloudflare WARP\Cloudflare WARP.exe` | | ||
| | **Logs Location** | <details><summary>Daemon</summary><br/>`C:\ProgramData\Cloudflare\`</details><br/><details><summary>GUI Logs</summary><br/>`C:\Users\<USER>.WARP\AppData\Local`<br/>or<br/>`%LOCALAPPDATA%\Cloudflare`</details> | |
There was a problem hiding this comment.
This isn't specific to this Windows item only but it seems like there's an empty line that makes the expand/collapse look a little odd?
...cs/cloudflare-one/connections/connect-devices/warp/troubleshooting/troubleshooting-guide.mdx
Show resolved
Hide resolved
...cs/cloudflare-one/connections/connect-devices/warp/troubleshooting/troubleshooting-guide.mdx
Outdated
Show resolved
Hide resolved
|
|
||
| After updating the WARP client, monitor the issue to see if it recurs. If the issue persists, continue with the troubleshooting guide. | ||
|
|
||
| :::tip[Check the device's WARP version] |
There was a problem hiding this comment.
Nit: Our style guide recommends that we use only note and caution asides. Maybe this is something we can discuss in T. Critique.
...cs/cloudflare-one/connections/connect-devices/warp/troubleshooting/troubleshooting-guide.mdx
Outdated
Show resolved
Hide resolved
...cs/cloudflare-one/connections/connect-devices/warp/troubleshooting/troubleshooting-guide.mdx
Outdated
Show resolved
Hide resolved
...cs/cloudflare-one/connections/connect-devices/warp/troubleshooting/troubleshooting-guide.mdx
Outdated
Show resolved
Hide resolved
| Exclude mode, with hosts/ips: | ||
| 1xx.1xx.1xx.1xx/25 (zoom) | ||
| ... | ||
| cname.user.net |
There was a problem hiding this comment.
Nit: Unless there's a specific reason to use this domain name, I would use one of the example domain names we have in our style guide.
...cs/cloudflare-one/connections/connect-devices/warp/troubleshooting/troubleshooting-guide.mdx
Outdated
Show resolved
Hide resolved
| </li> | ||
| </ul> | ||
|
|
||
| :::danger[Avoid vague ticket descriptions] |
There was a problem hiding this comment.
Nit: Same comment as above about recommended aside types (note and caution).
src/content/docs/learning-paths/warp-overview-course/series/warp-basics-1.mdx
Outdated
Show resolved
Hide resolved
src/content/docs/learning-paths/warp-overview-course/series/warp-basics-2.mdx
Outdated
Show resolved
Hide resolved
|
This PR requires additional review attention because it affects the following areas: PartialsThis PR updates partial files, which are pieces of content used across multiple files in our Render component.
|
* [CF1] warp troubleshooting * updates * update * updates * updates * updates * updates * update * edits * final edits to first draft * first draft edits, links, stream * sha256 check * extra additions * spelling edits * final edits * keehun edits * remove details unnecessary space * links * Apply suggestions from code review Co-authored-by: Pedro Sousa <[email protected]> * error fix * error fixes --------- Co-authored-by: Pedro Sousa <[email protected]>
4 participants
Summary
PCX-18784
Screenshots (optional)
Documentation checklist