[Speed] Add comprehensive slow website troubleshooting guide#30878
Open
ngayerie wants to merge 12 commits into
Open
[Speed] Add comprehensive slow website troubleshooting guide#30878ngayerie wants to merge 12 commits into
ngayerie wants to merge 12 commits into
Conversation
Creates a new troubleshooting page that guides users through: - Identifying specific slow assets (not just 'my site is slow') - Using Observatory to analyze performance and enable optimizations - Analyzing origin performance with Origin Analytics - Using curl --write-out for detailed timing metrics - Investigating cache status with Cache Analytics - Diagnosing network issues with speed.cloudflare.com and MTR - Understanding network routing and how Argo Smart Routing helps The guide progresses from basic (browser dev tools) to advanced (MTR, curl timing) to serve both non-technical and technical users. Addresses SPM-2864
Contributor
|
This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:
|
ask-bonk
Bot
added
documentation
![ask-bonk[bot]](https://avatars.githubusercontent.com/in/2454580?s=60&v=4){kind=small}
|
|
||
| 1. Go to the [Cloudflare dashboard](https://dash.cloudflare.com/?to=/:account/:zone/traffic). | ||
| 2. Select **Argo Smart Routing**. | ||
| 3. Enable the feature. |
Contributor
There was a problem hiding this comment.
Use turn on instead of enable for toggle actions per the terminology guide:
Suggested change
| 3. Enable the feature. | |
| 3. Turn on the feature. |
|
|
||
| [Argo Smart Routing](/argo-smart-routing/) analyzes network conditions in real-time and routes traffic over the fastest paths, reducing latency by an average of 30%. | ||
|
|
||
| 1. Go to the [Cloudflare dashboard](https://dash.cloudflare.com/?to=/:account/:zone/traffic). |
Contributor
There was a problem hiding this comment.
Use DashButton for validated dashboard deeplinks instead of bare markdown links:
Suggested change
| 1. Go to the [Cloudflare dashboard](https://dash.cloudflare.com/?to=/:account/:zone/traffic). | |
| 1. Go to the Cloudflare dashboard. | |
| <DashButton url="/?to=/:account/:zone/traffic" /> |
Contributor
|
Review posted on PR #30878 Labels applied: PR Summary: Verdict: 8 inline suggestions posted. No build-breaking issues, but several style guide violations need attention before merge. Issues flagged:
Note for maintainers: |
- Moved troubleshooting-slow-website.mdx to troubleshooting/slow-website.mdx - Moved troubleshooting.mdx to troubleshooting/index.mdx - Updated index to use DirectoryListing component
Contributor
|
This PR requires additional review attention because it affects the following areas: RedirectsThis PR changes current filenames or deletes current files. Make sure you have redirects set up to cover the following paths:
|
- Remove deprecated Auto Minify reference - Update Origin Analytics location to Speed > Origin Analytics - Remove 'Using a CDN for static assets' (covered in cache section) - Expand caching intro to explain why caching improves performance - Split cache section into 'Investigate why not cached' and 'Cache additional content' - Update Argo section to mention Smart Shield and correct enable links
Contributor
Restores the original behavior that lists all faq/troubleshooting pages from the entire speed directory, not just the troubleshooting folder.
…ng troubleshooting Based on support case analysis: - Added prominent section at the start to verify cf-ray header and DNS proxy status - Expanded Step 7 with 'Troubleshoot unexpected routing' subsection - Corrected routing information: Cloudflare prioritizes reliability over proximity - Added plan-based routing differences (Enterprise vs other plans) - Added link to geographic-traffic-routing troubleshooting page - Updated summary checklist to include verification step
- Remove plan-based routing information - Remove 'What you can do' column from table - Rename 'Likely cause' to 'Explanation' - Move 'Normal behavior' note into explanation for routing changes
- /speed/optimization/content/brotli/ -> /speed/optimization/content/compression/ - /cache/how-to/cache-rules/examples/ignore-set-cookie-header/ -> /cache/concepts/cache-behavior/#interaction-of-set-cookie-response-header-with-cache
Co-authored-by: ask-bonk[bot] <249159057+ask-bonk[bot]@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a comprehensive troubleshooting guide for diagnosing and resolving slow website performance issues.
Problem
Users often report "my website is slow" without understanding how to identify the root cause. There was no dedicated guide walking users through the diagnostic process from basic to advanced techniques.
Solution
Created
/speed/troubleshooting-slow-website/- a step-by-step guide that progresses from beginner to advanced:curl --write-outfor detailed timingKey messages:
Ticket