commit ab9acb2f7b92fa70b33c0f9c6980a604a84e346d
Author: Karsten Loesing <[email protected]>
Date: Wed Dec 5 21:19:10 2018 +0100
Schedule changes related to #28353.
In roughly two weeks from now we're going to update one bandwidth
graph and remove two obsolete ones.
Similar to commit b14dbc3, announce this change now, so that any folks
using our CSV files get the chance to update their tools.
---
src/main/resources/web/json/metrics.json | 8 ++++----
src/main/resources/web/jsps/stats.jsp | 25 ++++++++++++++++++++-----
2 files changed, 24 insertions(+), 9 deletions(-)
diff --git a/src/main/resources/web/json/metrics.json
b/src/main/resources/web/json/metrics.json
index 527f13f..9cb50ad 100644
--- a/src/main/resources/web/json/metrics.json
+++ b/src/main/resources/web/json/metrics.json
@@ -68,9 +68,9 @@
},
{
"id": "bandwidth",
- "title": "Total relay bandwidth",
+ "title": "Total relay bandwidth (deprecated)",
"type": "Graph",
- "description": "<p>This graph shows the total <a
href=\"glossary.html#advertised-bandwidth\">advertised</a> and <a
href=\"glossary.html#bandwidth-history\">consumed bandwidth</a> of all <a
href=\"glossary.html#relay\">relays</a> in the network.</p>",
+ "description": "<p>This graph shows the total <a
href=\"glossary.html#advertised-bandwidth\">advertised</a> and <a
href=\"glossary.html#bandwidth-history\">consumed bandwidth</a> of all <a
href=\"glossary.html#relay\">relays</a> in the network. <strong>This graph will
disappear by December 20, 2018, because it won't contain anything new compared
to the soon-to-be tweaked <a href=\"/bandwidth-flags.html\">Advertised and
consumed bandwidth by relay flags</a> graph.</strong></p>",
"function": "bandwidth",
"parameters": [
"start",
@@ -79,9 +79,9 @@
},
{
"id": "bwhist-flags",
- "title": "Consumed bandwidth by Exit/Guard flag combination",
+ "title": "Consumed bandwidth by Exit/Guard flag combination (deprecated)",
"type": "Graph",
- "description": "<p>This graph shows the <a
href=\"glossary.html#bandwidth-history\">consumed bandwidth</a> reported by
relays, subdivided into four distinct subsets by assigned \"Exit\" and/or
\"Guard\" <a href=\"glossary.html#relay-flag\">flags</a>.</p>",
+ "description": "<p>This graph shows the <a
href=\"glossary.html#bandwidth-history\">consumed bandwidth</a> reported by
relays, subdivided into four distinct subsets by assigned \"Exit\" and/or
\"Guard\" <a href=\"glossary.html#relay-flag\">flags</a>. <strong>This graph
will disappear by December 20, 2018, because it won't contain anything new
compared to the soon-to-be tweaked <a href=\"/bandwidth-flags.html\">Advertised
and consumed bandwidth by relay flags</a> graph.</strong></p>",
"function": "bwhist_flags",
"parameters": [
"start",
diff --git a/src/main/resources/web/jsps/stats.jsp
b/src/main/resources/web/jsps/stats.jsp
index 17a49ac..002a3af 100644
--- a/src/main/resources/web/jsps/stats.jsp
+++ b/src/main/resources/web/jsps/stats.jsp
@@ -48,7 +48,8 @@ https://metrics.torproject.org/identifier.csv
<li><b>August 15, 2018:</b> Made the first batch of changes to per-graph CSV
files.</li>
<li><b>September 15, 2018:</b> Removed all pre-aggregated CSV files.</li>
<li><b>October 28, 2018:</b> Added and/or removed columns to <a
href="#webstats-tb-platform">Tor Browser downloads and updates by platform</a>
and <a href="#webstats-tb-locale">Tor Browser downloads and updates by
locale</a> graphs.</li>
-<li><b>December 20, 2018:</b> Remove source parameters and output rows with
aggregates over all sources from <a href="#torperf">Time to download files over
Tor</a>, <a href="#torperf-failures">Timeouts and failures of downloading files
over Tor</a>, <a href="#onionperf-buildtimes">Circuit build times</a>, <a
href="#onionperf-latencies">Circuit round-trip latencies</a> graphs.</li>
+<li><b>December 20, 2018 (scheduled):</b> Remove source parameters and output
rows with aggregates over all sources from <a href="#torperf">Time to download
files over Tor</a>, <a href="#torperf-failures">Timeouts and failures of
downloading files over Tor</a>, <a href="#onionperf-buildtimes">Circuit build
times</a>, <a href="#onionperf-latencies">Circuit round-trip latencies</a>
graphs.</li>
+<li><b>December 20, 2018 (scheduled):</b> Remove two graphs <a
href="#bandwidth">Total relay bandwidth</a> and <a
href="#bwhist-flags">Consumed bandwidth by Exit/Guard flag combination</a>, and
update the data format of the <a href="#bandwidth-flags">Advertised and
consumed bandwidth by relay flag</a> graph to cover all data previously
contained in the first two graphs.</li>
</ul>
</div>
@@ -336,6 +337,11 @@ Traffic <a href="#traffic" name="traffic"
class="anchor">#</a></h2>
<a href="/bandwidth.csv" class="btn btn-primary btn-xs"><i class="fa
fa-chevron-right" aria-hidden="true"></i> data</a>
<a href="#bandwidth" name="bandwidth" class="anchor">#</a></h3>
+<div class="bs-callout bs-callout-warning">
+<h3>Deprecated</h3>
+<p>This graph will disappear by December 20, 2018, because it won't contain
anything new compared to the soon-to-be tweaked <a
href="#bandwidth-flags">Advertised and consumed bandwidth by relay flags</a>
graph.</p>
+</div>
+
<h4>Parameters</h4>
<ul>
@@ -367,10 +373,14 @@ Traffic <a href="#traffic" name="traffic"
class="anchor">#</a></h2>
<ul>
<li><b>date:</b> UTC date (YYYY-MM-DD) that relays reported bandwidth data
for.</li>
-<li><b>guard_advbw:</b> Total advertised bandwidth in Gbit/s that relays with
the <b>"Guard"</b> relay flag are capable to provide.</li>
-<li><b>guard_bwhist:</b> Total consumed bandwidth in Gbit/s as the average of
written and read traffic of relays with the <b>"Guard"</b> relay flag.</li>
-<li><b>exit_advbw:</b> Total advertised bandwidth in Gbit/s that relays with
the <b>"Exit"</b> relay flag are capable to provide.</li>
-<li><b>exit_bwhist:</b> Total consumed bandwidth in Gbit/s as the average of
written and read traffic of relays with the <b>"Exit"</b> relay flag.</li>
+<li><b>guard_advbw:</b> Total advertised bandwidth in Gbit/s that relays with
the <b>"Guard"</b> relay flag are capable to provide. <span class="red">This
column is going to be removed after December 20, 2018.</span></li>
+<li><b>guard_bwhist:</b> Total consumed bandwidth in Gbit/s as the average of
written and read traffic of relays with the <b>"Guard"</b> relay flag. <span
class="red">This column is going to be removed after December 20,
2018.</span></li>
+<li><b>exit_advbw:</b> Total advertised bandwidth in Gbit/s that relays with
the <b>"Exit"</b> relay flag are capable to provide. <span class="red">This
column is going to be removed after December 20, 2018.</span></li>
+<li><b>exit_bwhist:</b> Total consumed bandwidth in Gbit/s as the average of
written and read traffic of relays with the <b>"Exit"</b> relay flag. <span
class="red">This column is going to be removed after December 20,
2018.</span></li>
+<li><b>have_guard_flag:</b> Whether relays included in this row had the
<code>"Guard"</code> relay flag assigned (<code>"t"</code>) or not
(<code>"f"</code>). <span class="blue">This column is going to be added after
December 20, 2018.</span></li>
+<li><b>have_exit_flag:</b> Whether relays included in this row had the
<code>"Exit"</code> relay flag assigned and at the same time the
<code>"BadExit"</code> not assigned (<code>"t"</code>) or not
(<code>"f"</code>). <span class="blue">This column is going to be added after
December 20, 2018.</span></li>
+<li><b>advbw:</b> Total advertised bandwidth in Gbit/s that relays are capable
to provide. <span class="blue">This column is going to be added after December
20, 2018.</span></li>
+<li><b>bwhist:</b> Total consumed bandwidth in Gbit/s as the average of
written and read traffic. <span class="blue">This column is going to be added
after December 20, 2018.</span></li>
</ul>
<h3>Advertised bandwidth by IP version
@@ -446,6 +456,11 @@ Traffic <a href="#traffic" name="traffic"
class="anchor">#</a></h2>
<a href="/bwhist-flags.csv" class="btn btn-primary btn-xs"><i class="fa
fa-chevron-right" aria-hidden="true"></i> data</a>
<a href="#bwhist-flags" name="bwhist-flags" class="anchor">#</a></h3>
+<div class="bs-callout bs-callout-warning">
+<h3>Deprecated</h3>
+<p>This graph will disappear by December 20, 2018, because it won't contain
anything new compared to the soon-to-be tweaked <a
href="#bandwidth-flags">Advertised and consumed bandwidth by relay flags</a>
graph.</p>
+</div>
+
<h4>Parameters</h4>
<ul>
_______________________________________________
tor-commits mailing list
[email protected]
https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-commits
