[Magic] Troubleshoot IPsec with logpush (#25418)

marciocloudflare · Maddy-Cloudflare · web-flow · commit a8711f8cc301 · 2025-09-25T14:23:12.000Z
* created ipsec-log partial

* moved partial

* added pages to mwan mt

* page weights

* corrected name

* page weights

* Apply suggestions from code review

Co-authored-by: Maddy &lt;130055405+Maddy-Cloudflare@users.noreply.github.com&gt;

* refine text

---------

Co-authored-by: Maddy &lt;130055405+Maddy-Cloudflare@users.noreply.github.com&gt;
diff --git a/src/content/docs/magic-transit/alerts.mdx b/src/content/docs/magic-transit/alerts.mdx
@@ -2,7 +2,7 @@
 title: Alerts
 pcx_content_type: reference
 sidebar:
-  order: 13
+  order: 14
 
 ---
 
diff --git a/src/content/docs/magic-transit/analytics/index.mdx b/src/content/docs/magic-transit/analytics/index.mdx
@@ -2,7 +2,7 @@
 title: Analytics
 pcx_content_type: how-to
 sidebar:
-  order: 8
+  order: 9
 head: []
 description: Use Magic Transit's different analytic options for an overview of
   the performance of your sites, or to troubleshoot potential issues.
diff --git a/src/content/docs/magic-transit/changelog.mdx b/src/content/docs/magic-transit/changelog.mdx
@@ -2,7 +2,7 @@
 pcx_content_type: changelog
 title: Changelog
 sidebar:
-  order: 16
+  order: 17
 head: []
 description: Review recent changes to Magic Transit.
 ---
diff --git a/src/content/docs/magic-transit/cloudflare-ips.mdx b/src/content/docs/magic-transit/cloudflare-ips.mdx
@@ -2,7 +2,7 @@
 title: Cloudflare IPs
 pcx_content_type: concept
 sidebar:
-  order: 10
+  order: 11
 ---
 
 import { Render } from "~/components"
diff --git a/src/content/docs/magic-transit/ddos.mdx b/src/content/docs/magic-transit/ddos.mdx
@@ -2,7 +2,7 @@
 title: DDoS protection
 pcx_content_type: concept
 sidebar:
-  order: 7
+  order: 8
 head:
   - tag: title
     content: Cloudflare DDoS protection
diff --git a/src/content/docs/magic-transit/ipsec-troubleshoot.mdx b/src/content/docs/magic-transit/ipsec-troubleshoot.mdx
@@ -0,0 +1,15 @@
+---
+title: Troubleshoot with IPsec logs
+pcx_content_type: how-to
+sidebar:
+  order: 7
+---
+
+import { Render } from "~/components"
+
+<Render file="ipsec-logs-troubleshooting"
+	product="networking-services"
+	params={{
+		productName: "Magic Transit"
+		}}
+/>
diff --git a/src/content/docs/magic-transit/magic-network-monitoring.mdx b/src/content/docs/magic-transit/magic-network-monitoring.mdx
@@ -2,7 +2,7 @@
 title: Magic Network Monitoring
 pcx_content_type: concept
 sidebar:
-  order: 9
+  order: 10
 
 ---
 
diff --git a/src/content/docs/magic-transit/network-interconnect.mdx b/src/content/docs/magic-transit/network-interconnect.mdx
@@ -2,7 +2,7 @@
 title: Network Interconnect (CNI)
 pcx_content_type: concept
 sidebar:
-  order: 12
+  order: 13
 head:
   - tag: title
     content: Network Interconnect and Magic Transit
diff --git a/src/content/docs/magic-transit/on-demand.mdx b/src/content/docs/magic-transit/on-demand.mdx
@@ -2,7 +2,7 @@
 title: Magic Transit on-demand
 pcx_content_type: concept
 sidebar:
-  order: 11
+  order: 12
 head:
   - tag: title
     content: Magic Transit on-demand
diff --git a/src/content/docs/magic-transit/partners/index.mdx b/src/content/docs/magic-transit/partners/index.mdx
@@ -2,7 +2,7 @@
 title: Partners
 pcx_content_type: navigation
 sidebar:
-  order: 14
+  order: 15
   group:
     hideIndex: true
 
diff --git a/src/content/docs/magic-transit/reference/index.mdx b/src/content/docs/magic-transit/reference/index.mdx
@@ -2,7 +2,7 @@
 title: Reference
 pcx_content_type: navigation
 sidebar:
-  order: 15
+  order: 16
   group:
     hideIndex: true
 
diff --git a/src/content/docs/magic-wan/configuration/index.mdx b/src/content/docs/magic-wan/configuration/index.mdx
@@ -2,7 +2,7 @@
 title: Configuration
 pcx_content_type: navigation
 sidebar:
-  order: 5
+  order: 4
   group:
     hideIndex: true
 
diff --git a/src/content/docs/magic-wan/get-started.mdx b/src/content/docs/magic-wan/get-started.mdx
@@ -2,7 +2,7 @@
 title: Get started
 pcx_content_type: navigation
 sidebar:
-  order: 3
+  order: 2
 ---
 
 import { GlossaryTooltip, Render } from "~/components";
diff --git a/src/content/docs/magic-wan/ipsec-troubleshoot.mdx b/src/content/docs/magic-wan/ipsec-troubleshoot.mdx
@@ -0,0 +1,15 @@
+---
+title: Troubleshoot with IPsec logs
+pcx_content_type: how-to
+sidebar:
+  order: 5
+---
+
+import { Render } from "~/components"
+
+<Render file="ipsec-logs-troubleshooting"
+	product="networking-services"
+	params={{
+		productName: "Magic WAN"
+		}}
+/>
diff --git a/src/content/docs/magic-wan/on-ramps.mdx b/src/content/docs/magic-wan/on-ramps.mdx
@@ -2,7 +2,7 @@
 title: On-ramps
 pcx_content_type: reference
 sidebar:
-  order: 4
+  order: 3
 ---
 
 To on-ramp your network traffic to Magic WAN, you can use [Magic WAN Connector](/magic-wan/configuration/connector/), a lightweight software package you can install in corporate network locations to automatically connect, steer, and shape any IP traffic.
diff --git a/src/content/partials/networking-services/ipsec-logs-troubleshooting.mdx b/src/content/partials/networking-services/ipsec-logs-troubleshooting.mdx
@@ -0,0 +1,15 @@
+---
+params:
+  - productName
+---
+
+{props.productName}	customers can use IPsec logs to help them troubleshoot issues with their IPsec tunnels. This functionality is specifically aimed at the key-exchange portion of the IPsec handshake, where customers can run into issues. With IPsec logs, customers can set up a logpush job to forward their IPsec logs to their preferred storage service. Once they have the logs, they can investigate and find the root cause of their key exchange issues.
+
+## Set up an IPsec logpush job
+
+1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login).
+2. Go to **Analytics & Logs** > **Logpush**.
+3. Select **Create a Logpush job**.
+4. Select **IPsec logs** as your dataset.
+
+Refer to the [Logpush documentation](/logs/logpush/) for more information about features and availability.
