Skip to content

Commit 43a8809

Browse files
committed
[Stream] live stream troubleshooting guide
1 parent 99cad4a commit 43a8809

File tree

1 file changed

+30
-4
lines changed

1 file changed

+30
-4
lines changed

src/content/docs/stream/stream-live/troubleshooting.mdx

Lines changed: 30 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,18 +5,44 @@ sidebar:
55
order: 12
66

77
---
8+
import { Steps, Details } from "~/components"
9+
10+
In addition to following the live stream troubleshooting steps in this guide, make sure that your video settings align with [Cloudflare live stream recommendations](/stream/stream-live/start-stream-live/#recommendations-requirements-and-limitations). If you use OBS, you can also check these [OBS-specific recommendations](/stream/examples/obs-from-scratch/#6-optional-optimize-settings).
811

912
## Buffering, freezing, and latency
1013

11-
If your live stream is buffering, freezing, experiencing latency issues, switching in quality levels, or having other similar issues, take these steps.
14+
If your live stream is buffering, freezing, experiencing latency issues, switching in quality levels, or having other similar issues, try these troubleshooting steps:
1215

16+
<Steps>
1317
1. Go to the [Cloudflare dashboard](https://dash.cloudflare.com) > **Stream** > **Analytics**.
1418

15-
2. Look at your **Keyframe Interval** chart. It should be a consistent flat line that stays between 2s and 6s. If instead you see:
16-
* An inconsistent or wavy line
17-
* A line that is consistency below 2s or above 6s
19+
2. Look at your **Keyframe Interval** chart.
20+
21+
It should be a consistent flat line that stays between 2s and 6s. If instead you see an inconsistent or wavy line a line, or a line that is consistently below 2s or above 6s, edit the keyframe interval (also called GOP) in your software or service used send the stream to Cloudflare. The exact steps for editing those settings will depend on your platform.
22+
* If the keyframe interval or GOP is below 2s, raise it to 2s.
23+
* If it is above 4s, lower it to 4s.
24+
* If the keyframe interval is "variable", change it to a specific number, like 4s.
25+
26+
<Details header="What is a keyframe interval?">
27+
The keyframe interval (also called GOP) is ________.
28+
</Details>
29+
30+
3. Look at your **Upload-to-Duration Ratio** chart.
31+
32+
It should be a consistent flat line between 50% and 70%. If instead you see an inconsistent or wavy line, or a line that is consistently below 50% or above 70%, try the following troubleshooting steps:
33+
34+
* Check that your internet speed upload bandwidth is between 2Mbps and 12Mbps.
35+
* If it is below 2Mbps, your internet connection is very slow. Use common troubleshooting steps such as restarting your router, using an Ethernet connection instead of Wi-Fi, or contacting your internet service provider.
36+
* If it is above 12Mbps, try adjusting your video bitrate to be between 50% and 70% of your internet speed. To do so, edit the bitrate setting in your software or service you use to send the stream to Cloudflare. If the bitrate is "variable", change it to a specific number between 50% and 70% of your internet speed.
37+
<br/>
38+
* Follow the steps above (in step 2) to edit the keyframe interval in the software or service you use to send the stream to Cloudflare.
1839

40+
<Details header="What is an upload-to-duration ratio?">
41+
The upload-to-duration ratio measures ________.
42+
</Details>
43+
</Steps>
1944

45+
## Error codes for live stream
2046

2147

2248

0 commit comments

Comments
 (0)