Skip to content

Commit 8ed6ce5

Browse files
[CF1] device monitoring (#19521)
* [CF1] device monitoring * Update src/content/docs/cloudflare-one/insights/dex/remote-captures.mdx * Update src/content/docs/cloudflare-one/insights/dex/monitoring.mdx
1 parent 2e0fcd3 commit 8ed6ce5

File tree

6 files changed

+106
-65
lines changed

6 files changed

+106
-65
lines changed

public/_redirects

+1
Original file line numberDiff line numberDiff line change
@@ -1894,6 +1894,7 @@
18941894
/cloudflare-one/policies/browser-isolation/agentless/* /cloudflare-one/policies/browser-isolation/setup/:splat 301
18951895
/cloudflare-one/policies/filtering/http-policies/data-loss-prevention/* /cloudflare-one/policies/data-loss-prevention/ 301
18961896
/cloudflare-one/policies/data-loss-prevention/configuration-guides/* /cloudflare-one/policies/data-loss-prevention/dlp-policies/common-policies/ 301
1897+
/cloudflare-one/insights/dex/fleet-status/ /cloudflare-one/insights/dex/monitoring/ 301
18971898

18981899
# Learning paths
18991900
/learning-paths/modules/cybersafe/cybersafe-account-creation/* /learning-paths/cybersafe/account-creation/:splat 301

src/content/docs/cloudflare-one/insights/dex/fleet-status.mdx

-41
This file was deleted.

src/content/docs/cloudflare-one/insights/dex/ip-visibility.mdx

+2-2
Original file line numberDiff line numberDiff line change
@@ -48,11 +48,11 @@ DEX's IP visibility allows you to review an event log of a device's IP history f
4848
4. View the device's IP history and status from the last seven days.
4949
5. Select a time to view more information about the device at that time.
5050

51-
Refer to [Available metrics](/cloudflare-one/insights/dex/fleet-status/#available-metrics) to review **Status** and **Mode** descriptions.
51+
Refer to [Available metrics](/cloudflare-one/insights/dex/monitoring/#available-metrics) to review **Status** and **Mode** descriptions.
5252

5353
## Troubleshoot with IP visibility
5454

55-
While IP visibility allows you to inspect a device's IP information, use [DEX's live analytics](/cloudflare-one/insights/dex/fleet-status/#available-metrics) to review which Cloudflare data center the device is connected to. When traffic leaves a WARP-connected end-user device, it will hit a [Cloudflare data center](/support/troubleshooting/general-troubleshooting/gathering-information-for-troubleshooting-sites/#identify-the-cloudflare-data-center-serving-your-request).
55+
While IP visibility allows you to inspect a device's IP information, use [DEX's live analytics](/cloudflare-one/insights/dex/monitoring/#available-metrics) to review which Cloudflare data center the device is connected to. When traffic leaves a WARP-connected end-user device, it will hit a [Cloudflare data center](/support/troubleshooting/general-troubleshooting/gathering-information-for-troubleshooting-sites/#identify-the-cloudflare-data-center-serving-your-request).
5656

5757
To find which Cloudflare data center a device is connected to:
5858

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,81 @@
1+
---
2+
pcx_content_type: reference
3+
title: Monitoring
4+
sidebar:
5+
order: 1
6+
---
7+
8+
Monitor performance and network status for your organization's [fleet](/cloudflare-one/insights/dex/monitoring/#fleet-status) or individual [user devices](/cloudflare-one/insights/dex/monitoring/#device-monitoring).
9+
10+
Network and device performance data helps IT administrators troubleshoot performance issues, investigate network connectivity problems, and monitor device health.
11+
12+
## Fleet status
13+
14+
A fleet is a collection of user devices. All devices in a fleet have WARP installed and are connected to a [Cloudflare Zero Trust organization](/cloudflare-one/setup/#create-a-zero-trust-organization).
15+
16+
To view fleet status:
17+
18+
1. In [Zero Trust](https://one.dash.cloudflare.com/), go to **DEX** > **Monitoring**.
19+
2. In **DEX Monitoring**, review the information under the **Fleet Status** tab.
20+
21+
### View metrics
22+
23+
The **Fleet Status** tab will show real-time and historical connectivity metrics for all devices in your organization.
24+
25+
To view analytics on a per-device level, go to [Device monitoring](/cloudflare-one/insights/dex/monitoring/#device-monitoring).
26+
27+
### Available metrics
28+
29+
- **Devices connected by colo**: Number of devices that are connected to a given [Cloudflare data center](https://www.cloudflarestatus.com/).
30+
31+
- **Connectivity status**: Percentage of devices in a given WARP client state.
32+
33+
| Status | Description |
34+
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
35+
| Connected | WARP has successfully established a connection to the Cloudflare global network. |
36+
| Disconnected | WARP has been intentionally or unintentionally disconnected from the Cloudflare global network. |
37+
| Paused | A user or administrator has taken an explicit action to temporarily turn off WARP, for example by entering an [Admin Override](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-settings/#admin-override) code. Paused clients will [auto-connect](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-settings/#auto-connect) after a timeout period. |
38+
| Connecting | WARP is pending connection, but is actively trying to establish a connection to the Cloudflare global network. |
39+
40+
- **Mode**: [WARP mode](/cloudflare-one/connections/connect-devices/warp/configure-warp/warp-modes/) deployed on the device.
41+
42+
- **Colo**: Percentage of devices connected to a given Cloudflare data center.
43+
44+
- **Platform**: Operating system of the device.
45+
46+
- **Major Version**: WARP client version installed on the device.
47+
48+
- **Device Status Over Time**: WARP client connection status over the selected time period.
49+
50+
- **Connection Methods Over Time**: WARP mode used by the device over the selected time period.
51+
52+
## Device monitoring
53+
54+
Review network and device performance for a device enrolled in your fleet.
55+
56+
### View a device's performance
57+
58+
To view a device's network and device performance metrics:
59+
60+
1. In [Zero Trust](https://one.dash.cloudflare.com/), go to **My team** > **Devices**.
61+
2. Select a device > **View details**.
62+
3. Select the **DEX** tab.
63+
4. In **Device Monitoring**, scroll down to **Network performance** and **Device Performance**.
64+
65+
### Network and device performance metrics
66+
67+
#### Network performance metrics
68+
69+
- **Unique networks over time**: How many unique SSIDs the device was connected to.
70+
71+
- **Network I/O**: How much data has been transferred (uploads and downloads) over the primary network interface.
72+
73+
#### Device performance metrics
74+
75+
- **Battery percentage and cycles**: Displays battery percentage and [battery cycles](https://support.apple.com/en-us/102888) over time. Used to debug potential performance issues possibly related to battery health or power-saving measures that are triggered at low-battery levels.
76+
77+
- **CPU usage**: CPU utilization over time. Used to debug slow system performance due to high CPU usage.
78+
79+
- **Memory utilization**: Memory utilization over time. Used to debug performance issues related to an overtaxed memory.
80+
81+
- **Disk I/O**: Displays number of disk read/write operations over time. Used to debug performance errors due to heavy disk operations.

src/content/docs/cloudflare-one/insights/dex/remote-captures.mdx

+20-19
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ sidebar:
55
order: 4
66
---
77

8-
import { Details } from "~/components"
8+
import { Details } from "~/components";
99

1010
<Details header="Feature availability">
1111

@@ -15,12 +15,12 @@ import { Details } from "~/components"
1515

1616
| System | Availability | Minimum WARP version |
1717
| -------- | ------------ | -------------------- |
18-
| Windows | | 2024.12.492.0 |
19-
| macOS | | 2024.12.492.0 |
20-
| Linux | | 2024.12.492.0 |
21-
| iOS | | |
22-
| Android | | |
23-
| ChromeOS | | |
18+
| Windows || 2024.12.492.0 |
19+
| macOS || 2024.12.492.0 |
20+
| Linux || 2024.12.492.0 |
21+
| iOS || |
22+
| Android || |
23+
| ChromeOS || |
2424

2525
</Details>
2626

@@ -33,22 +33,22 @@ To capture data from a remote device:
3333
1. In [Zero Trust](https://one.dash.cloudflare.com/), go to **DEX** > **Remote captures**.
3434
2. Select up to 10 devices that you want to run a capture on. Devices must be [registered](/cloudflare-one/connections/connect-devices/warp/deployment/) in your Zero Trust organization.
3535
3. Configure the types of captures to run.
36-
- **PCAP**: Performs packet captures for traffic outside of the WARP tunnel (default network interface) and traffic inside of the WARP tunnel ([WARP virtual interface](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#ip-traffic)).
37-
- **WARP Diagnostics Logs**: Generates a [WARP diagnostic log](/cloudflare-one/connections/connect-devices/warp/troubleshooting/warp-logs/#warp-diag-logs) of the past 96 hours. To include a routing test for all IPs and domains in your [Split Tunnel configuration](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/split-tunnels/), select **Test all routes**.
38-
:::note
39-
**Test all routes** will extend the time for diagnostics to run and may temporarily impact device performance during the test.
40-
:::
36+
- **PCAP**: Performs packet captures for traffic outside of the WARP tunnel (default network interface) and traffic inside of the WARP tunnel ([WARP virtual interface](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/warp-architecture/#ip-traffic)).
37+
- **WARP Diagnostics Logs**: Generates a [WARP diagnostic log](/cloudflare-one/connections/connect-devices/warp/troubleshooting/warp-logs/#warp-diag-logs) of the past 96 hours. To include a routing test for all IPs and domains in your [Split Tunnel configuration](/cloudflare-one/connections/connect-devices/warp/configure-warp/route-traffic/split-tunnels/), select **Test all routes**.
38+
:::note
39+
**Test all routes** will extend the time for diagnostics to run and may temporarily impact device performance during the test.
40+
:::
4141
4. Select **Start a capture**.
4242

4343
DEX will now send capture requests to the configured devices. If the WARP client is disconnected, the capture will time out after 10 minutes.
4444

4545
## Check remote capture status
4646

4747
To view a list of captures, go to **DEX** > **Remote captures**. The **Status** column displays one of the following options:
48-
- **Success**: The capture is complete and ready for download. Any partially successful captures will still upload to Cloudflare. For example, there could be a scenario where the PCAP succeeds on the primary network interface but fails on the WARP tunnel interface. You can [review PCAP results](/cloudflare-one/insights/dex/remote-captures/#download-remote-captures) to determine which PCAPs succeeded or failed.
49-
- **Running**: The capture is in progress on the device.
50-
- **Pending Upload**: The capture is complete but not yet ready for download.
51-
- **Failed**: The capture has either timed out or encountered an error. To retry the capture, check the WARP client version and [connectivity status](/cloudflare-one/insights/dex/fleet-status/), then start a [new capture](/cloudflare-one/insights/dex/remote-captures/#start-a-remote-capture).
48+
- **Success**: The capture is complete and ready for download. Any partially successful captures will still upload to Cloudflare. For example, there could be a scenario where the PCAP succeeds on the primary network interface but fails on the WARP tunnel interface. You can [review PCAP results](/cloudflare-one/insights/dex/remote-captures/#download-remote-captures) to determine which PCAPs succeeded or failed.
49+
- **Running**: The capture is in progress on the device.
50+
- **Pending Upload**: The capture is complete but not yet ready for download.
51+
- **Failed**: The capture has either timed out or encountered an error. To retry the capture, check the WARP client version and [connectivity status](/cloudflare-one/insights/dex/monitoring/#fleet-status), then start a [new capture](/cloudflare-one/insights/dex/remote-captures/#start-a-remote-capture).
5252

5353
## Download remote captures
5454

@@ -61,6 +61,7 @@ This will download a ZIP file to your local machine called `<capture-id>.zip`. D
6161
### Device PCAP contents
6262

6363
The downloaded PCAP folder contains three files:
64+
6465
- `capture-default.pcap`: Packet captures for the primary network interface.
6566
- `capture-tunnel.pcap`: Packet captures for traffic inside of the WARP tunnel.
6667
- `results.json`: Reports successful and failed packet captures.
@@ -74,8 +75,8 @@ Refer to [WARP diagnostic logs](/cloudflare-one/connections/connect-devices/warp
7475
## Limitations
7576

7677
- Packet captures are subject to the following limits:
77-
- **Maximum time limit**: 600 seconds
78-
- **Maximum file size**: 50 MB
79-
- **Maximum packet size**: 1500 bytes
78+
- **Maximum time limit**: 600 seconds
79+
- **Maximum file size**: 50 MB
80+
- **Maximum packet size**: 1500 bytes
8081
- WARP diagnostic logs have no file size limit, but files larger than 100 MB cannot be uploaded to Cloudflare and must be shared directly with the admin.
8182
- Windows devices do not support concurrent remote captures. If you start a remote capture while another is in progress, the second capture will fail immediately.

src/content/docs/cloudflare-one/insights/dex/tests/index.mdx

+2-3
Original file line numberDiff line numberDiff line change
@@ -3,11 +3,10 @@ pcx_content_type: navigation
33
title: Tests
44
sidebar:
55
order: 2
6-
76
---
87

9-
import { DirectoryListing } from "~/components"
8+
import { DirectoryListing } from "~/components";
109

11-
With Digital Experience Monitoring (DEX), you can test if your devices can connect to a private or public endpoint through the WARP client. This tool allows you to monitor availability for a given application and investigate performance issues reported by your end users. DEX tests will only run when the WARP client is turned on, whereas [fleet status](/cloudflare-one/insights/dex/fleet-status/) metrics are always available.
10+
With Digital Experience Monitoring (DEX), you can test if your devices can connect to a private or public endpoint through the WARP client. This tool allows you to monitor availability for a given application and investigate performance issues reported by your end users. DEX tests will only run when the WARP client is turned on, whereas [fleet status](/cloudflare-one/insights/dex/monitoring/#fleet-status) metrics are always available.
1211

1312
<DirectoryListing />

0 commit comments

Comments
 (0)