search

prometheus / docs

Prometheus documentation: content and static site generator
https://prometheus.io
Apache License 2.0
651 stars 1k forks source link

Broken links #2464

Open alexandear opened 4 months ago

alexandear commented 4 months ago

The https://prometheus.io/ website has 5 broken links:

  1. Page: Querying basics Text: Ingesting native histograms has to be enabled via a feature flag. Actual: https://www.prometheus.io/docs/prometheus/feature_flags/#native-histograms Expected: https://www.prometheus.io/docs/prometheus/latest/feature_flags/#native-histograms

  2. Page: Query functions Text: Ingesting native histograms has to be enabled via a feature flag. Actual: https://www.prometheus.io/docs/prometheus/feature_flags/#native-histograms Expected: https://www.prometheus.io/docs/prometheus/latest/feature_flags/#native-histograms

  3. Page: Alerting based on metrics Text: In this tutorial we will create alerts on the ping_request_count metric that we instrumented earlier in the Instrumenting HTTP server written in Go tutorial. Actual: https://www.prometheus.io/docs/tutorials/alerting_based_on_metrics/instrumenting_http_server_in_go/ Expected: https://www.prometheus.io/docs/tutorials/instrumenting_http_server_in_go/

  4. Page: Announcing Prometheus 2.0 Text: Check the Prometheus 1.x to 2.0 migration guide for a full overview of changes and how to adapt your setup to them. Actual: https://prometheus.io/docs/prometheus/2.0/migration/ Expected: https://prometheus.io/docs/prometheus/latest/migration/

  5. Page: Monitoring DreamHack - the World's Largest Digital Festival Text: To achieve this we used PromDash. Actual: https://prometheus.io/docs/visualization/promdash/ Expected: https://prometheus.io/docs/introduction/glossary/#promdash

The full log of running linkchecker ``` ❯ linkchecker --no-warnings https://prometheus.io/ INFO linkcheck.cmdline 2024-05-15 19:20:17,817 MainThread Checking intern URLs only; use --check-extern to check extern URLs. LinkChecker 10.4.0 Copyright (C) 2000-2016 Bastian Kleineidam, 2010-2023 LinkChecker Authors LinkChecker comes with ABSOLUTELY NO WARRANTY! This is free software, and you are welcome to redistribute it under certain conditions. Look at the file `COPYING' within this distribution. Read the documentation at https://linkchecker.github.io/linkchecker/ Write comments and bugs to https://github.com/linkchecker/linkchecker/issues Start checking at 2024-05-15 19:20:17+003 10 threads active, 64 links queued, 50 links in 124 URLs checked, runtime 1 seconds 10 threads active, 53 links queued, 67 links in 130 URLs checked, runtime 6 seconds 10 threads active, 238 links queued, 796 links in 1044 URLs checked, runtime 11 seconds 10 threads active, 227 links queued, 1140 links in 1377 URLs checked, runtime 16 seconds 10 threads active, 213 links queued, 1154 links in 1377 URLs checked, runtime 21 seconds 10 threads active, 198 links queued, 1169 links in 1377 URLs checked, runtime 26 seconds 10 threads active, 186 links queued, 1181 links in 1377 URLs checked, runtime 31 seconds 10 threads active, 181 links queued, 1297 links in 1488 URLs checked, runtime 36 seconds 10 threads active, 171 links queued, 1323 links in 1504 URLs checked, runtime 41 seconds 10 threads active, 163 links queued, 1376 links in 1549 URLs checked, runtime 46 seconds 10 threads active, 152 links queued, 1489 links in 1651 URLs checked, runtime 51 seconds 10 threads active, 154 links queued, 1563 links in 1727 URLs checked, runtime 56 seconds 10 threads active, 138 links queued, 1596 links in 1744 URLs checked, runtime 1 minute, 1 seconds 10 threads active, 124 links queued, 1610 links in 1744 URLs checked, runtime 1 minute, 6 seconds 10 threads active, 112 links queued, 1623 links in 1745 URLs checked, runtime 1 minute, 11 seconds 10 threads active, 99 links queued, 1636 links in 1745 URLs checked, runtime 1 minute, 16 seconds 10 threads active, 88 links queued, 1647 links in 1745 URLs checked, runtime 1 minute, 21 seconds 10 threads active, 79 links queued, 1734 links in 1823 URLs checked, runtime 1 minute, 26 seconds 10 threads active, 62 links queued, 1751 links in 1823 URLs checked, runtime 1 minute, 31 seconds 10 threads active, 59 links queued, 1845 links in 1914 URLs checked, runtime 1 minute, 36 seconds URL `../../../feature_flags/#native-histograms' Name `feature\nflag' Parent URL https://prometheus.io/docs/prometheus/latest/querying/basics/, line 218, col 57 Real URL https://prometheus.io/docs/prometheus/feature_flags/#native-histograms Check time 3.685 seconds Result Error: 404 Not Found 10 threads active, 54 links queued, 1878 links in 1942 URLs checked, runtime 1 minute, 41 seconds URL `../feature_flags/' Name `feature flag' Parent URL https://prometheus.io/docs/prometheus/latest/querying/functions/, line 982, col 52 Real URL https://prometheus.io/docs/prometheus/latest/querying/feature_flags/ Check time 3.266 seconds Result Error: 404 Not Found 10 threads active, 40 links queued, 1892 links in 1943 URLs checked, runtime 1 minute, 46 seconds 10 threads active, 60 links queued, 1905 links in 1979 URLs checked, runtime 1 minute, 51 seconds URL `./instrumenting_http_server_in_go/' Name `Instrumenting HTTP server written in Go' Parent URL https://prometheus.io/docs/tutorials/alerting_based_on_metrics/, line 136, col 1 Real URL https://prometheus.io/docs/tutorials/alerting_based_on_metrics/instrumenting_http_server_in_go/ Check time 3.222 seconds Result Error: 404 Not Found 10 threads active, 45 links queued, 1920 links in 1979 URLs checked, runtime 1 minute, 56 seconds URL `/docs/prometheus/2.0/migration/' Name `Prometheus 1.x to 2.0' Parent URL https://prometheus.io/blog/2017/11/08/announcing-prometheus-2-0/, line 158, col 73 Real URL https://prometheus.io/docs/prometheus/2.0/migration/ Check time 3.183 seconds Result Error: 404 Not Found 10 threads active, 31 links queued, 1934 links in 1979 URLs checked, runtime 2 minutes, 1 seconds URL `/docs/visualization/promdash/' Name `PromDash' Parent URL https://prometheus.io/blog/2015/06/24/monitoring-dreamhack/, line 323, col 39 Real URL https://prometheus.io/docs/visualization/promdash/ Check time 3.521 seconds Result Error: 404 Not Found 10 threads active, 15 links queued, 1950 links in 1979 URLs checked, runtime 2 minutes, 6 seconds 10 threads active, 129 links queued, 1967 links in 2110 URLs checked, runtime 2 minutes, 11 seconds 10 threads active, 226 links queued, 1983 links in 2223 URLs checked, runtime 2 minutes, 16 seconds 10 threads active, 217 links queued, 2001 links in 2232 URLs checked, runtime 2 minutes, 21 seconds 10 threads active, 203 links queued, 2015 links in 2232 URLs checked, runtime 2 minutes, 26 seconds 10 threads active, 186 links queued, 2032 links in 2232 URLs checked, runtime 2 minutes, 31 seconds 10 threads active, 180 links queued, 2044 links in 2238 URLs checked, runtime 2 minutes, 36 seconds 10 threads active, 164 links queued, 2061 links in 2239 URLs checked, runtime 2 minutes, 41 seconds 10 threads active, 156 links queued, 2078 links in 2248 URLs checked, runtime 2 minutes, 46 seconds 10 threads active, 147 links queued, 2091 links in 2252 URLs checked, runtime 2 minutes, 51 seconds 10 threads active, 148 links queued, 2105 links in 2267 URLs checked, runtime 2 minutes, 56 seconds 10 threads active, 131 links queued, 2122 links in 2267 URLs checked, runtime 3 minutes, 1 seconds 10 threads active, 119 links queued, 2134 links in 2267 URLs checked, runtime 3 minutes, 6 seconds 10 threads active, 106 links queued, 2147 links in 2267 URLs checked, runtime 3 minutes, 11 seconds 10 threads active, 91 links queued, 2162 links in 2267 URLs checked, runtime 3 minutes, 16 seconds 10 threads active, 85 links queued, 2176 links in 2275 URLs checked, runtime 3 minutes, 21 seconds 10 threads active, 71 links queued, 2190 links in 2275 URLs checked, runtime 3 minutes, 26 seconds 10 threads active, 60 links queued, 2205 links in 2279 URLs checked, runtime 3 minutes, 31 seconds URL `../../../feature_flags/#native-histograms' Name `feature\nflag' Parent URL https://www.prometheus.io/docs/prometheus/latest/querying/basics/, line 218, col 57 Real URL https://www.prometheus.io/docs/prometheus/feature_flags/#native-histograms Check time 2.843 seconds Result Error: 404 Not Found 10 threads active, 60 links queued, 2220 links in 2294 URLs checked, runtime 3 minutes, 36 seconds 10 threads active, 47 links queued, 2233 links in 2294 URLs checked, runtime 3 minutes, 41 seconds URL `../feature_flags/' Name `feature flag' Parent URL https://www.prometheus.io/docs/prometheus/latest/querying/functions/, line 982, col 52 Real URL https://www.prometheus.io/docs/prometheus/latest/querying/feature_flags/ Check time 4.034 seconds Result Error: 404 Not Found 10 threads active, 34 links queued, 2246 links in 2297 URLs checked, runtime 3 minutes, 46 seconds URL `./instrumenting_http_server_in_go/' Name `Instrumenting HTTP server written in Go' Parent URL https://www.prometheus.io/docs/tutorials/alerting_based_on_metrics/, line 136, col 1 Real URL https://www.prometheus.io/docs/tutorials/alerting_based_on_metrics/instrumenting_http_server_in_go/ Check time 2.946 seconds Result Error: 404 Not Found 10 threads active, 18 links queued, 2262 links in 2297 URLs checked, runtime 3 minutes, 51 seconds URL `/docs/prometheus/2.0/migration/' Name `Prometheus 1.x to 2.0' Parent URL https://www.prometheus.io/blog/2017/11/08/announcing-prometheus-2-0/, line 158, col 73 Real URL https://www.prometheus.io/docs/prometheus/2.0/migration/ Check time 2.984 seconds Result Error: 404 Not Found 10 threads active, 4 links queued, 2276 links in 2297 URLs checked, runtime 3 minutes, 56 seconds URL `/docs/visualization/promdash/' Name `PromDash' Parent URL https://www.prometheus.io/blog/2015/06/24/monitoring-dreamhack/, line 323, col 39 Real URL https://www.prometheus.io/docs/visualization/promdash/ Check time 3.262 seconds Result Error: 404 Not Found Statistics: Downloaded: 11.4MB. Content types: 318 image, 338 text, 0 video, 0 audio, 31 application, 0 mail and 1603 other. URL lengths: min=14, max=182, avg=64. That's it. 2290 links in 2299 URLs checked. 0 warnings found (57 ignored or duplicates not printed). 10 errors found. Stopped checking at 2024-05-15 19:24:19+003 (4 minutes, 1 seconds) ```
juliusv commented 15 hours ago

Thanks, I created (belatedly) a PR at https://github.com/prometheus/docs/pull/2518