Commit b14dbc36 authored by Karsten Loesing's avatar Karsten Loesing
Browse files

Schedule changes related to #28603. 

In roughly two weeks from now we're going to remove source parameters
and output rows with aggregates over all sources from all
Torperf/OnionPerf related graphs.

Announce this change now, so that any folks using our CSV files get
the chance to update their tools.
parent d4b17e90

src/main/resources/web/css/style.css

+7 −2
Original line number Diff line number Diff line
@@ -897,9 +897,14 @@ body.noscript #navbar-toggle-checkbox:checked ~ .collapse { 
.onionoo th.method { width:10%; }

.onionoo th.url { width:40%; }

.onionoo th.description { width:50%; }

.onionoo span.red {





/* Styles used on our various protocol specification pages. */



span.red {

    color:#d9534f;

}

.onionoo span.blue {

span.blue {

    color:#337ab7;

}

src/main/resources/web/jsps/stats.jsp

+9 −8
Original line number Diff line number Diff line
@@ -48,6 +48,7 @@ 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>

</ul>



</div>
@@ -520,7 +521,7 @@ Performance <a href="#performance" name="performance" class="anchor">#</a></h2> 
<ul>

<li><b>start:</b> First UTC date (YYYY-MM-DD) to include in the file.</li>

<li><b>end:</b> Last UTC date (YYYY-MM-DD) to include in the file.</li>

<li><b>source:</b> Name of the OnionPerf or Torperf service performing measurements, or <b>"all"</b> for measurements performed by any service.</li>

<li><b>source:</b> Name of the OnionPerf or Torperf service performing measurements, or <b>"all"</b> for measurements performed by any service. <span class="red">This parameter is going to be removed after December 20, 2018.</span></li>

<li><b>server:</b> Either <b>"public"</b> for requests to a server on the public internet, or <b>"onion"</b> for requests to a version 2 onion server.</li>

<li><b>filesize:</b> Size of the downloaded file in bytes, with pre-defined possible values: <b>"50kb"</b>, <b>"1mb"</b>, or <b>"5mb"</b>.</li>

</ul>
@@ -530,7 +531,7 @@ Performance <a href="#performance" name="performance" class="anchor">#</a></h2> 
<ul>

<li><b>date:</b> UTC date (YYYY-MM-DD) when download performance was measured.</li>

<li><b>filesize:</b> Size of the downloaded file in bytes.</li>

<li><b>source:</b> Name of the OnionPerf or Torperf service performing measurements. If this column contains the empty string, all measurements are included, regardless of which service performed them.</li>

<li><b>source:</b> Name of the OnionPerf or Torperf service performing measurements. If this column contains the empty string, all measurements are included, regardless of which service performed them. <span class="red">Output rows with aggregates over all sources are going to be removed after December 20, 2018.</span></li>

<li><b>server:</b> Either <b>"public"</b> if the request was made to a server on the public internet, or <b>"onion"</b> if the request was made to a version 2 onion server.</li>

<li><b>q1:</b> First quartile of time in milliseconds until receiving the last byte.</li>

<li><b>md:</b> Median of time in milliseconds until receiving the last byte.</li>
@@ -547,7 +548,7 @@ Performance <a href="#performance" name="performance" class="anchor">#</a></h2> 
<ul>

<li><b>start:</b> First UTC date (YYYY-MM-DD) to include in the file.</li>

<li><b>end:</b> Last UTC date (YYYY-MM-DD) to include in the file.</li>

<li><b>source:</b> Name of the OnionPerf or Torperf service performing measurements, or <b>"all"</b> for measurements performed by any service.</li>

<li><b>source:</b> Name of the OnionPerf or Torperf service performing measurements, or <b>"all"</b> for measurements performed by any service. <span class="red">This parameter is going to be removed after December 20, 2018.</span></li>

<li><b>server:</b> Either <b>"public"</b> for requests to a server on the public internet, or <b>"onion"</b> for requests to a version 2 onion server.</li>

<li><b>filesize:</b> Size of the downloaded file in bytes, with pre-defined possible values: <b>"50kb"</b>, <b>"1mb"</b>, or <b>"5mb"</b>.</li>

</ul>
@@ -557,7 +558,7 @@ Performance <a href="#performance" name="performance" class="anchor">#</a></h2> 
<ul>

<li><b>date:</b> UTC date (YYYY-MM-DD) when download performance was measured.</li>

<li><b>filesize:</b> Size of the downloaded file in bytes.</li>

<li><b>source:</b> Name of the OnionPerf or Torperf service performing measurements. If this column contains the empty string, all measurements are included, regardless of which service performed them.</li>

<li><b>source:</b> Name of the OnionPerf or Torperf service performing measurements. If this column contains the empty string, all measurements are included, regardless of which service performed them. <span class="red">Output rows with aggregates over all sources are going to be removed after December 20, 2018.</span></li>

<li><b>server:</b> Either <b>"public"</b> if the request was made to a server on the public internet, or <b>"onion"</b> if the request was made to a version 2 onion server.</li>

<li><b>timeouts:</b> Fraction of requests that timed out when attempting to download the static file over Tor.</li>

<li><b>failures:</b> Fraction of requests that failed when attempting to download the static file over Tor.</li>
@@ -573,14 +574,14 @@ Performance <a href="#performance" name="performance" class="anchor">#</a></h2> 
<ul>

<li><b>start:</b> First UTC date (YYYY-MM-DD) to include in the file.</li>

<li><b>end:</b> Last UTC date (YYYY-MM-DD) to include in the file.</li>

<li><b>source:</b> Name of the OnionPerf or Torperf service performing measurements, or <b>"all"</b> for measurements performed by any service.</li>

<li><b>source:</b> Name of the OnionPerf or Torperf service performing measurements, or <b>"all"</b> for measurements performed by any service. <span class="red">This parameter is going to be removed after December 20, 2018.</span></li>

</ul>



<h4>Columns</h4>



<ul>

<li><b>date:</b> UTC date (YYYY-MM-DD) when download performance was measured.</li>

<li><b>source:</b> Name of the OnionPerf or Torperf service performing measurements. If this column contains the empty string, all measurements are included, regardless of which service performed them.</li>

<li><b>source:</b> Name of the OnionPerf or Torperf service performing measurements. If this column contains the empty string, all measurements are included, regardless of which service performed them. <span class="red">Output rows with aggregates over all sources are going to be removed after December 20, 2018.</span></li>

<li><b>position:</b> Position in the circuit, from first to third hop.</li>

<li><b>q1:</b> First quartile of time in milliseconds until successfully extending the circuit to the given position.</li>

<li><b>md:</b> Median of time in milliseconds until successfully extending the circuit to the given position.</li>
@@ -597,14 +598,14 @@ Performance <a href="#performance" name="performance" class="anchor">#</a></h2> 
<ul>

<li><b>start:</b> First UTC date (YYYY-MM-DD) to include in the file.</li>

<li><b>end:</b> Last UTC date (YYYY-MM-DD) to include in the file.</li>

<li><b>source:</b> Name of the OnionPerf or Torperf service performing measurements, or <b>"all"</b> for measurements performed by any service.</li>

<li><b>source:</b> Name of the OnionPerf or Torperf service performing measurements, or <b>"all"</b> for measurements performed by any service. <span class="red">This parameter is going to be removed after December 20, 2018.</span></li>

</ul>



<h4>Columns</h4>



<ul>

<li><b>date:</b> UTC date (YYYY-MM-DD) when download performance was measured.</li>

<li><b>source:</b> Name of the OnionPerf or Torperf service performing measurements. If this column contains the empty string, all measurements are included, regardless of which service performed them.</li>

<li><b>source:</b> Name of the OnionPerf or Torperf service performing measurements. If this column contains the empty string, all measurements are included, regardless of which service performed them. <span class="red">Output rows with aggregates over all sources are going to be removed after December 20, 2018.</span></li>

<li><b>server:</b> Either <b>"public"</b> if the request was made to a server on the public internet, or <b>"onion"</b> if the request was made to a version 2 onion server.</li>

<li><b>q1:</b> First quartile of time in milliseconds between sending the HTTP request and receiving the HTTP response header.</li>

<li><b>md:</b> Median of time in milliseconds between sending the HTTP request and receiving the HTTP response header.</li>