Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
54 commits
Select commit Hold shift + click to select a range
3b4c7b9
changed name to config connector
marciocloudflare Jan 15, 2025
06b4d5f
refactored connector partial
marciocloudflare Jan 15, 2025
813b0c7
corrected links
marciocloudflare Jan 15, 2025
88fad05
updated steps numbers and ha configs
marciocloudflare Jan 15, 2025
6a882fd
corrected numbers
marciocloudflare Jan 15, 2025
b4a187d
changed partial name
marciocloudflare Jan 15, 2025
7e4f318
refined text
marciocloudflare Jan 15, 2025
f9786a6
refined text
marciocloudflare Jan 15, 2025
5d3ad13
corrected link
marciocloudflare Jan 15, 2025
6d84256
added sites info to pages
marciocloudflare Jan 15, 2025
e8a6e26
created sites brief partial
marciocloudflare Jan 15, 2025
a245d30
removed next step
marciocloudflare Jan 15, 2025
991a5d4
changed where add sites appear in the flow
marciocloudflare Jan 15, 2025
2ffcb0b
Merge branch 'production' into marcio/pcx12480-mwan-sites
marciocloudflare Jan 16, 2025
c123e3c
created sites page
marciocloudflare Jan 16, 2025
47104a7
reordered pages
marciocloudflare Jan 16, 2025
40c7f62
moved site title
marciocloudflare Jan 16, 2025
2170655
added intro
marciocloudflare Jan 16, 2025
8c2726b
Merge branch 'production' into marcio/pcx12480-mwan-sites
marciocloudflare Jan 16, 2025
5981aaa
added content
marciocloudflare Jan 16, 2025
ffe52cc
corrected dash path
marciocloudflare Jan 16, 2025
3abd103
corrected dash path
marciocloudflare Jan 16, 2025
1cb8717
corrected path
marciocloudflare Jan 16, 2025
cabd970
removed spaces
marciocloudflare Jan 16, 2025
0e1f998
corrected dash path
marciocloudflare Jan 16, 2025
9d84c71
corrected dash path
marciocloudflare Jan 16, 2025
761de72
corrected interface address name tunnels
marciocloudflare Jan 16, 2025
ed6bdfb
refined text
marciocloudflare Jan 16, 2025
d6e173c
steps to add a site
marciocloudflare Jan 16, 2025
c21ec93
deleted old content
marciocloudflare Jan 16, 2025
b7c8cc7
added site analytics info
marciocloudflare Jan 16, 2025
5151124
link to sites
marciocloudflare Jan 16, 2025
c25aa1f
link to sites
marciocloudflare Jan 16, 2025
17a452b
added beta to network overview
marciocloudflare Jan 16, 2025
b275aea
added beta to connector on-ramps
marciocloudflare Jan 16, 2025
deb0b8c
Merge branch 'production' into marcio/pcx12480-mwan-sites
marciocloudflare Jan 16, 2025
47cf427
Merge remote-tracking branch 'origin/production' into marcio/pcx12480…
marciocloudflare Jan 20, 2025
6420794
Merge remote-tracking branch 'origin/production' into marcio/pcx12480…
marciocloudflare Jan 22, 2025
1174694
Merge remote-tracking branch 'origin/production' into marcio/pcx12480…
marciocloudflare Jan 23, 2025
8bcad25
Merge remote-tracking branch 'origin/production' into marcio/pcx12480…
marciocloudflare Jan 27, 2025
6a766fa
Merge remote-tracking branch 'origin/production' into marcio/pcx12480…
marciocloudflare Jan 28, 2025
182f10e
Merge remote-tracking branch 'origin/production' into marcio/pcx12480…
marciocloudflare Jan 30, 2025
2273016
added sites to flow
marciocloudflare Jan 31, 2025
cc0fc8d
refined text
marciocloudflare Jan 31, 2025
cb1dc5c
removed site from workflow
marciocloudflare Jan 31, 2025
2185d45
refined step number
marciocloudflare Jan 31, 2025
3d900da
Merge branch 'production' into marcio/pcx12480-mwan-sites
marciocloudflare Feb 3, 2025
ccb8eb9
Merge remote-tracking branch 'origin/production' into marcio/pcx12480…
marciocloudflare Feb 4, 2025
0673e48
Merge remote-tracking branch 'origin/production' into marcio/pcx12480…
marciocloudflare Feb 10, 2025
df2ab63
Merge remote-tracking branch 'origin/production' into marcio/pcx12480…
marciocloudflare Feb 11, 2025
4874ecd
Apply suggestions from code review
marciocloudflare Feb 11, 2025
0034e71
Update src/content/docs/magic-wan/configuration/common-settings/sites…
marciocloudflare Feb 11, 2025
dbfc947
step consistent with network segmentation
marciocloudflare Feb 11, 2025
a9e7472
added beta
marciocloudflare Feb 11, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
91 changes: 4 additions & 87 deletions src/content/docs/magic-wan/analytics/site-analytics.mdx
Original file line number Diff line number Diff line change
@@ -1,98 +1,15 @@
---
title: Site Analytics
title: Site analytics
pcx_content_type: how-to
sidebar:
order: 1
head:
- tag: title
content: Magic WAN Site Analytics
content: Magic WAN site analytics

---

import { Details } from "~/components"
After adding sites to your Magic WAN, the Network overview (beta) section of the dashboard provides you a summary of the connectivity status and traffic analytics for all your sites. This is a great place to start if you receive a Magic WAN alert, need to begin the troubleshooting process, or are performing routine monitoring.

Magic WAN Site Analytics provides an overview of the connectivity status and traffic analytics of all Magic WAN Connector sites. Magic WAN Site Analytics is a great place to start if you receive a Magic WAN alert, need to begin the Magic WAN Connector troubleshooting process, or are performing routine monitoring.
Refer to [Set up a site](/magic-wan/configuration/common-settings/sites/) for more information.

Magic WAN Site Analytics has the following data types available:

<Details header="Geographic map summary">
- [Aggregate Magic WAN site health](#site-health)
- [Magic WAN availability status for sites](#no-status-available)
- [Magic WAN site geographic location](#no-location-available)
</Details>

<Details header="Magic WAN site data table">
- Site Name
- Site Health
- Site Tunnel Names
- Site Tunnel Statuses
- Site Traffic Sent
- Site Traffic Received
</Details>

<Details header="Magic WAN site data">
- Traffic Sent by Tunnel
- Traffic Received by Tunnel
</Details>

To start using Magic WAN Site Analytics:

1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account.
2. Select **Magic WAN** > **Overview**.

You will have access to an overview map with all your active sites, and any alerts for sites that are unhealthy or have no status available to them.

Review the topics below to learn more about the options available to you.

### All sites

This section shows all the sites you configured with Magic WAN. At a glance, you can check:

- How many active sites you have
- Sites that are healthy or unhealthy
- Sites that have no status available
- Sites that have no location set

#### Site health

Sites can be healthy or unhealthy, and Magic WAN uses this information to route traffic. Refer to [Set thresholds for Magic WAN site health](#set-thresholds-for-magic-wan-site-health) to learn more about this topic.

#### No status available

The status of a site refers to its health. If your sites show a **No status available** message, this means you did not configure your [Tunnel health check alerts](/magic-wan/configuration/common-settings/configure-magic-tunnel-alerts/).

#### No location available

The dashboard shows you the number of sites with no location set, meaning sites for which you did not set up a geographic location. To add a location to a site, find the site you want to add location to, and select **no location set** to edit its location settings. Refer to [Set geographic coordinates](#set-geographic-coordinates) for more information.


### Traffic overview

Traffic overview aggregates all Magic WAN sites configured in your account. Here, you can check at-a-glance information about each site like:

- Site status
- Traffic sent and received

Select one of your sites to have access to a more detailed view of its traffic, including traffic by tunnel.

---

## Configure Magic WAN Site Analytics

### Set geographic coordinates

When you create a site, you can set geographic coordinates in order for it to show on the Overview map. You can also add this information to sites you have already created. To add a Magic WAN site to the geographic map in the Overview page:

1. Go to **Magic WAN** > **Sites**.
2. Select a specific site > **Edit**.
3. Scroll to **Site Location**.
4. Set the **latitude** and **longitude** coordinates of the Magic WAN Site.
5. Scroll down and select **Save**.
6. The Magic WAN Site will now appear on the geographic map in the Overview page.

### Set thresholds for Magic WAN site health

You can set Magic Tunnel health alerts to receive alerts when the percentage of successful health checks for a Magic Tunnel drops below the selected service-level objective (SLO). Setting health alerts will also show unhealthy tunnels in the Overview map:

1. Configure [Magic Tunnel health alerts](/magic-wan/configuration/common-settings/configure-magic-tunnel-alerts/) across all of the Magic Tunnels associated with each Magic WAN Site.
2. After configuring Magic Tunnel health alerts, any Magic WAN Site with a Magic Tunnel that is outside of its SLO threshold will be labeled unhealthy in the Overview map.
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
pcx_content_type: how-to
title: Check tunnel health in the dashboard
sidebar:
order: 2
order: 3
---

import { Render } from "~/components";
Expand All @@ -12,7 +12,7 @@ import { Render } from "~/components";
params={{
dashInfo:
"The dashboard shows the view of tunnel health as measured from each Cloudflare location where your traffic is likely to land.",
productPath: "**Magic WAN** > **Tunnel health check**",
productPath: "**Magic WAN** > **Tunnel health**",
}}
/>

Expand Down
131 changes: 131 additions & 0 deletions src/content/docs/magic-wan/configuration/common-settings/sites.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,131 @@
---
title: Set up a site
pcx_content_type: how-to
sidebar:
order: 2
---

import { Details } from "~/components"

Sites represent the local network of a data center, office, or other physical location, and combine all on-ramps available there. Sites also allow you to check, at a glance, the state of your on-ramps and set up health alert settings so that you get notified when there are issues with the site's on-ramps.

To use a site, start by setting up your on-ramps. These can be [GRE or IPsec tunnels](/magic-wan/configuration/manually/how-to/configure-tunnels/), a [Magic WAN Connector](/magic-wan/configuration/connector/), or a direct [CNI link](/magic-wan/network-interconnect/). When you are finished setting these up, refer to the steps below to learn how to set up a site.

## Add a site

1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account.
2. Go to **Magic WAN** > **Network overview (beta)**.
3. Select **Create site**. If this is not the first time you are adding a site, you will have the option **Add site** instead.
4. Add a name and description for your new site. Optionally, you can also add the geographical coordinates for your site in **Latitude** and **Longitude**. If you add geographical coordinates, once created your site's location will show in the map.
5. Select **Create and continue**.
6. Choose one or more on-ramps for your site from the list. Remember to only choose the on-ramps available to that particular site, as the list might show on-ramps available on other locations.
7. Select **Continue**.
8. In **Define alert settings** you set up alerts to notify you when there are issues with your site's on-ramps. If you want to set up alerts later, select **Skip this for now** to complete your setup. Otherwise, continue reading.
9. In **Magic WAN Health Check Alert** > **Notification name**, enter a name for the site's alert.
9. Under **Alert settings**, choose how you want to be notified when there is an issue. You can add webhooks as well as email addresses.
10. In **Alert sensitivity level** define the threshold for Magic Tunnel health alerts to be fired. Available options are _Low_, _Medium_, and _High_. Refer to [Magic Tunnels background information](/magic-wan/reference/magic-tunnels/) for more information.
11. Select **Complete setup** to finish setting up your site.

Your site is now set up. If you have other sites you need to set up, repeat the steps above. If you did not set up alerts, we strongly recommend that you do it. Otherwise you will not be notified when there is a problem with one of your on-ramps.

---

## Site analytics

After adding your sites, the Network overview (beta) section of the dashboard provides a summary of the connectivity status and traffic analytics for all your sites. This is a great place to start if you receive a Magic WAN alert, need to begin the troubleshooting process, or are performing routine monitoring.

Network overview (beta) has the following data types available:

<Details header="Geographic map summary">
- [Aggregate Magic WAN site health](#site-health)
- [Magic WAN availability status for sites](#no-status-available)
- [Magic WAN site geographic location](#no-location-set)
</Details>

<Details header="Magic WAN site data table">
- Site Name
- Site Health
- Site Tunnel Names
- Site Tunnel Statuses
- Site Traffic Sent
- Site Traffic Received
</Details>

<Details header="Magic WAN site data">
- Traffic Sent by Tunnel
- Traffic Received by Tunnel
</Details>

To start using Magic WAN site analytics:

1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account.
2. Select **Magic WAN** > **Network overview (beta)**.

You will have access to an overview map with all your active sites, and any alerts for sites that are unhealthy or have no status available to them.

Review the topics below to learn more about the options available to you.

### Network map and traffic overview

The network map section shows all the sites configured with Magic WAN. At a glance, you can check:

- How many active sites you have
- Location for sites in a map (if you set up their geographic location)
- Sites that are healthy or unhealthy
- Sites that have no status available
- Sites that have no location set

Just below the map, Traffic overview shows a more granular list of your sites and their status.

#### Site health

Sites can be healthy or unhealthy, and Magic WAN uses this information to route traffic. Refer to [Set thresholds for Magic WAN site health](#set-thresholds-for-magic-wan-site-health) to learn more about this topic.

#### No status available

The status of a site refers to its health. If your sites show a **No status available** message, this means you did not configure your alert settings when creating your site. Refer to [Configure Magic Tunnel health alerts](/magic-wan/configuration/common-settings/configure-magic-tunnel-alerts/) to learn how to create an alert for your site.

#### No location set

The dashboard shows you the number of sites with no location set, meaning sites for which you did not set up a geographic location. To add a location to a site, find the site you want to add location to, and select **no location set** to edit its location settings. Refer to [Set geographic coordinates](#set-geographic-coordinates) for more information.


### Traffic overview

Traffic overview aggregates all Magic WAN sites configured in your account. Here, you can check at-a-glance information about each site like:

- Site status
- Traffic sent and received

Select one of your sites to have access to a more detailed view of its traffic, including traffic by tunnel.

---

## Edit a site

### Add or remove on-ramps

1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account.
2. Go to **Magic WAN** > **Network overview (beta)**.
3. Find your site in **Traffic overview** > select the three dots in front of it > **Edit**.
4. Select **On-ramps**.
5. Select **Add** to add a new on-ramp.
6. If you want to remove an on-ramp, select the three dots in front of your on-ramp > **Remove**.

### Set geographic coordinates

If you add geographic coordinates to your site, it will show up in the Network map. To set up or edit geographic coordinates to an existing site:

1. Go to **Magic WAN** > **Network overview (beta)**.
2. Find your site in **Traffic overview** > select the three dots in front of it > **Edit**.
3. In **Basic information**, edit your site's **Latitude** and **Longitude** coordinates.
4. Select **Save**.

### Set thresholds for Magic WAN site health

When you set up an alert for your site, you will be notified when there is an issue with one or more on-ramps. These alerts are sent when the percentage of successful health checks for a Magic WAN on-ramp drops below the selected service-level objective (SLO). Setting health alerts will also show unhealthy tunnels in the Network map and in the Traffic overview sections.

To set up health alerts:

1. Configure [Magic Tunnel health alerts](/magic-wan/configuration/common-settings/configure-magic-tunnel-alerts/) across all of the Magic Tunnels associated with each Magic WAN site.
2. After configuring Magic Tunnel health alerts, any Magic WAN site with a Magic Tunnel (on-ramp) that is outside of its SLO threshold will be labeled unhealthy in Network map and Traffic overview.
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
pcx_content_type: how-to
title: Update tunnel health checks frequency
sidebar:
order: 3
order: 4
---

import { Render } from "~/components";
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ Refer to [SFP+ port information](/magic-wan/configuration/connector/configure-ha
## Set up Cloudflare dashboard

<Render
file="connector/create-site"
file="connector/connector-onramps"
params={{
wan: "refers to the physical Magic WAN Connector Ethernet port that you are using for your WAN. The ports are labeled `GE1`, `GE2`, `GE3`, `GE4`, `GE5`, and `GE6`. Choose the number corresponding to the port that you are using in Connector. <br> If you need a throughput higher than 1 Gbps, you can use one of the SFP+ ports. Refer to [SFP+ port information](/magic-wan/configuration/connector/configure-hardware-connector/sfp-port-information/) for more information on the hardware supported.",
lan: "refers to the physical Magic WAN Connector Ethernet port that you are using for your LAN. The ports are labeled `GE1`, `GE2`, `GE3`, `GE4`, `GE5`, and `GE6`. Choose a number corresponding to the port that you are using in Connector. <br> If you need a throughput higher than 1 Gbps, you can use one of the SFP+ ports. Refer to [SFP+ port information](/magic-wan/configuration/connector/configure-hardware-connector/sfp-port-information/) for more information on the hardware supported.",
Expand Down Expand Up @@ -133,16 +133,15 @@ Make sure you complete the setup workflow and activate your Magic WAN Connector
:::

1. Connect Magic WAN Connector to a DHCP port with access to the Internet.
2. [Create a site](#1-create-a-site) in the Cloudflare dashboard.
3. Associate a Connector to it.
4. Create a [DHCP WAN](#2-create-a-wan).
5. [Active](#activate-connector) and power on your Connector.
6. Wait 60 seconds.
7. Make changes to the [WAN settings](#2-create-a-wan) in the Cloudflare dashboard to a static IP set up.
8. Wait 60 seconds again.
9. Magic WAN Connector will go offline. This is normal and expected behavior.
10. Adjust your physical connections as required to match the static configuration.
11. Magic WAN Connector comes back online.
2. [Add a Connector on-ramp](#1-add-a-connector-on-ramp) in the Cloudflare dashboard.
3. Create a [DHCP WAN](#2-create-a-wan).
4. [Activate](#activate-connector) and power on your Connector.
5. Wait 60 seconds.
6. Make changes to the [WAN settings](#2-create-a-wan) in the Cloudflare dashboard to a static IP set up.
7. Wait 60 seconds again.
8. Magic WAN Connector will go offline. This is normal and expected behavior.
9. Adjust your physical connections as required to match the static configuration.
10. Magic WAN Connector comes back online.

---

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -104,7 +104,7 @@ You cannot use the same license key twice, or reuse a key once the virtual machi
## Set up Cloudflare dashboard

<Render
file="connector/create-site"
file="connector/connector-onramps"
params={{
wan: "needs to correspond to the virtual network interface on the Virtual Connector instance you have set up in VMware. Following our example from the previous steps, you need to choose port `1` since that is what corresponds to the `eno1` port we set up in VMware.",
lan: "needs to correspond to the virtual LAN interface on the Virtual Connector instance you have set up in VMware. Following our example from the previous steps, you need to choose port `2` since that is what corresponds to the `eno2` port we set up in VMware.",
Expand All @@ -126,7 +126,7 @@ You cannot use the same license key twice, or reuse a key once the virtual machi
## Boot your Virtual Connector

1. Go to **Virtual Machines** in VMware, and boot up Virtual Connector's VM.
2. The Virtual Connector will make a request to Cloudflare. This is the step where Virtual Connector registers your provided license key and [downloads the site configuration](#1-create-a-site) for its connected site.
2. The Virtual Connector will make a request to Cloudflare. This is the step where Virtual Connector registers your provided license key and downloads the [configuration you provided](#1-add-a-connector-on-ramp).
3. The Virtual Connector will set up the LAN and WAN connections according to the configuration downloaded from the site you created on the Cloudflare dashboard. The Virtual Connector will also establish IPsec tunnels.
4. If successful, the [tunnel health checks](/magic-wan/configuration/common-settings/check-tunnel-health-dashboard/) will show as healthy.
5. If you do not see a [healthy heartbeat](/magic-wan/configuration/connector/maintenance/heartbeat/) the Cloudflare dashboard, reboot the Virtual Connector's VM in VMware.
Expand All @@ -142,15 +142,14 @@ Make sure you complete the setup workflow and activate your Virtual Connector be
:::

1. Connect the machine where you installed the VM with Virtual Connector to a DHCP port with access to the Internet.
2. [Create a site](#1-create-a-site) in the Cloudflare dashboard.
3. Associate a Connector to it.
4. Create a [DHCP WAN](#2-create-a-wan).
5. [Active](#activate-connector) and boot your Virtual Connector.
6. Wait 60 seconds.
7. Make changes to the [WAN settings](#2-create-a-wan) in the Cloudflare dashboard to a static IP set up.
8. Wait 60 seconds again.
9. Modify your [Port Groups](#deploy-the-virtual-connector-on-vmware) as needed to change the source from which the WAN port obtains its IP address.
10. Reboot your virtual machine.
2. [Add a Connector on-ramp](#1-add-a-connector-on-ramp) in the Cloudflare dashboard.
3. Create a [DHCP WAN](#2-create-a-wan).
4. [Activate](#activate-connector) and boot your Virtual Connector.
5. Wait 60 seconds.
6. Make changes to the [WAN settings](#2-create-a-wan) in the Cloudflare dashboard to a static IP set up.
7. Wait 60 seconds again.
8. Modify your [Port Groups](#deploy-the-virtual-connector-on-vmware) as needed to change the source from which the WAN port obtains its IP address.
9. Reboot your virtual machine.

---

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,6 @@ You need to configure Breakout traffic for each of your existing sites, as it is
file="connector/app-aware-policies/add-app"
params={{ featureName: "Breakout traffic" }}
/>

6. Select one or more applications that should bypass Cloudflare filtering from the list. You can also use the search box.
7. Select **Add applications**.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,9 +29,9 @@ To configure DHCP relay:
<Tabs syncKey="dashPlusAPI"> <TabItem label="Dashboard">

1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account.
2. Go to **Magic WAN** > **Sites**.
3. Select your site > **Edit**.
4. Select **Network**.
2. Go to **Magic WAN** > **Connector on-ramps (beta)**.
3. Select your Connector > **Edit**.
4. Select **Network Configuration**.
5. In **LAN configuration**, select the LAN where you need to configure DHCP relay.
6. Select **Edit**.
7. Select **This is a DHCP Relay**.
Expand Down
Loading
Loading