Skip to content

Commit 61c9189

Browse files
committed
update warp-diag page
1 parent 34f34ee commit 61c9189

File tree

1 file changed

+44
-7
lines changed
  • src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting

1 file changed

+44
-7
lines changed

src/content/docs/cloudflare-one/connections/connect-devices/warp/troubleshooting/warp-logs.mdx

Lines changed: 44 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ sidebar:
66
label: Diagnostic logs
77
---
88

9-
import { TabItem, Tabs, Stream } from "~/components";
9+
import { TabItem, Tabs, Render, Details, Stream } from "~/components";
1010

1111
The WARP client provides diagnostic logs that you can use to troubleshoot connectivity issues on a device.
1212

@@ -29,9 +29,9 @@ The WARP client provides diagnostic logs that you can use to troubleshoot connec
2929

3030
## macOS/Windows/Linux
3131

32-
### Retrieve logs
32+
### Collect logs via the CLI
3333

34-
To view WARP logs on desktop devices:
34+
To collect WARP diagnostic logs on your desktop:
3535

3636
<Tabs> <TabItem label="macOS">
3737

@@ -65,9 +65,46 @@ This will place a `warp-debugging-info-<date>-<time>.zip` in the same folder you
6565

6666
</TabItem> </Tabs>
6767

68-
:::note
69-
You can also use Digital Experience Monitoring to run `warp-diag` commands on remote devices. For more information, refer to [Remote captures](/cloudflare-one/insights/dex/remote-captures/).
70-
:::
68+
### Collect logs via the dashboard
69+
70+
<Render file="dex/pcaps-run-availability" product="cloudflare-one" />
71+
72+
You can collect WARP diagnostic logs remotely from the Zero Trust dashboard by using Digital Experience Monitoring (DEX) [remote captures](/cloudflare-one/insights/dex/remote-captures/).
73+
74+
<Render file="dex/pcaps-run" product="cloudflare-one" />
75+
76+
#### Download remote captures
77+
78+
<Render file="dex/pcaps-download" product="cloudflare-one" />
79+
80+
#### Analyze remote captures (beta)
81+
82+
Cloudflare processes the WARP diagnostic logs that were [captured via the dashboard](#collect-logs-via-the-dashboard) and flags what we determine to be the most important detection events. You can use the WARP diagnostic summary to help you analyze your `warp-diag` logs and identify the root cause of client issues.
83+
84+
To access your WARP diagnostic summary:
85+
86+
1. In [Zero Trust](https://one.dash.cloudflare.com/), go to **DEX** > **Remote captures**.
87+
2. Locate an existing `warp-diag` log from the list or select **Run diagnostics** to generate a new `warp-diag` log.
88+
3. Select the three dots for the `warp-diag` log that you want to analyze, then select **View WARP Diag**.
89+
90+
The **Overview** tab will display an AI-generated summary of the results, a list of detection events, and basic device information.
91+
<Details header="Explanation of the fields">
92+
| Field | Description |
93+
| ----- | ----------- |
94+
| Detection type | A common WARP issue that can appear in the diagnostic logs. |
95+
| Occurences | Number of times an issue was detected in the logs. |
96+
| Severity level | Indicates the impact of the issue on WARP client functionality. The severity levels are: <ul> <li> **Critical**: Issue causes complete loss of functionality. </li> <li> **Warning**: Issue causes degraded functionality but core features should still work. </li> <li> **No detection**: Issue was not detected in the logs. </li> </ul> |
97+
| Operating system | OS and OS version of the device. |
98+
| WARP version | [WARP release version](/cloudflare-one/connections/connect-devices/warp/download-warp/) |
99+
| Profile ID | [WARP device profile](/cloudflare-one/connections/connect-devices/warp/configure-warp/device-profiles/)|
100+
| Service mode | [WARP mode](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-modes/) |
101+
| Configuration name | Name of the [Zero Trust organization](/cloudflare-one/connections/connect-devices/warp/deployment/mdm-deployment/switch-organizations/) that WARP is connected to. |
102+
| Device ID | ID generated by the WARP client. |
103+
104+
</Details>
105+
4. Select a detection type for more information about the event and the recommended next steps.
106+
107+
Cloudflare will store the `warp-diag` log and its summary per our [log retention policy](/cloudflare-one/insights/logs/#log-retention). To save a copy onto your local machine, [download the log file](#download-remote-captures) and go to the **JSON file** tab to copy the summary in JSON format.
71108

72109
### `warp-diag` logs
73110

@@ -172,7 +209,7 @@ Always check the timestamps at the end of each log file to verify the time range
172209

173210
## iOS/Android/ChromeOS
174211

175-
### Retrieve logs
212+
### Collect logs
176213

177214
To view WARP logs on mobile devices:
178215

0 commit comments

Comments
 (0)