Skip to content

Commit 7f514eb

Browse files
svenvg93gitbook-bot
authored andcommitted
GITBOOK-1: No subject
1 parent 44952e1 commit 7f514eb

File tree

2 files changed

+58
-0
lines changed

2 files changed

+58
-0
lines changed

SUMMARY.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,7 @@
3838

3939
## 👀 Other
4040

41+
* [Speedtest Process](other/speedtest-process.md)
4142
* [Proxies](other/proxies/README.md)
4243
* [Cloudflare Tunnel (Zero Trust)](other/proxies/cloudflare-tunnel-zero-trust.md)
4344
* [Traefik](other/proxies/traefik.md)

other/speedtest-process.md

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
# Speedtest Process
2+
3+
Speedtest Tracker uses the [Official Ookla CLI](https://www.speedtest.net/apps/cli) client to execute the speedtest. There a couple of stages the Speedtest Tracker goes through, below explains the process. 
4+
5+
{% stepper %}
6+
{% step %}
7+
### Started
8+
9+
The Speedtest process is started
10+
{% endstep %}
11+
12+
{% step %}
13+
### Checking
14+
15+
The application checks for an internet connection by calling `https://icanhazip.com`
16+
{% endstep %}
17+
18+
{% step %}
19+
### Skipped \[Optional]
20+
21+
If you have the `SPEEDTEST_SKIP_IPS` the test will be marked as skipped as the IP returning during `Checking` matches your defined IP.
22+
{% endstep %}
23+
24+
{% step %}
25+
### Running
26+
27+
The application runs the speedtest by simply running the speedtest command. This command runs the speedtest like another other speedtest and returns the result in json format so the application an easily process it. 
28+
29+
```
30+
speedtest -accept-license --accept-gdpr --format=json
31+
```
32+
33+
Or when you have defined a server id:
34+
35+
```
36+
speedtest -accept-license --accept-gdpr --format=json --server-id=YOURSERVERID
37+
```
38+
{% endstep %}
39+
40+
{% step %}
41+
### Failed
42+
43+
If for various reasons the Ookla CLI returns an error, because the defined server was offline for example the tests is marked as failed. As well when the `Checking` stage fails when there is no internet. 
44+
{% endstep %}
45+
46+
{% step %}
47+
### Benchmarking
48+
49+
When you have thresholds set this step will evaluate the results against the threshold to determine if the test was healthy or not.
50+
{% endstep %}
51+
52+
{% step %}
53+
### Completed
54+
55+
This is the end stage of the process when every step is completed the test is marked as such. 
56+
{% endstep %}
57+
{% endstepper %}

0 commit comments

Comments
 (0)