[Author Prev][Author Next][Thread Prev][Thread Next][Author Index][Thread Index]
[tor-commits] [metrics-web/master] Describe new keys in @type torperf 1.1.
commit acf61979af922d6948a10e286e1cff5ed1c9579b
Author: Karsten Loesing <karsten.loesing@xxxxxxx>
Date: Thu Jul 6 15:28:46 2017 +0200
Describe new keys in @type torperf 1.1.
Implements #22263.
---
.../src/main/resources/web/WEB-INF/collector.jsp | 39 +++++++++++-----------
1 file changed, 20 insertions(+), 19 deletions(-)
diff --git a/website/src/main/resources/web/WEB-INF/collector.jsp b/website/src/main/resources/web/WEB-INF/collector.jsp
index a6085f4..9edad80 100644
--- a/website/src/main/resources/web/WEB-INF/collector.jsp
+++ b/website/src/main/resources/web/WEB-INF/collector.jsp
@@ -160,11 +160,11 @@
<a href="https://collector.torproject.org/archive/exit-lists/"; target="_blank" class="btn btn-primary btn-xs pull-right"><i class="fa fa-chevron-right" aria-hidden="true"></i> archive</a></td>
</tr>
<tr class="tableHeadline">
- <td colspan="3"><b><a href="#torperf">Torperf's Performance Data</a></b></td>
+ <td colspan="3"><b><a href="#torperf">Torperf's and OnionPerf's Performance Data</a></b></td>
</tr>
<tr>
<td><a href="#type-torperf">Torperf Measurement Results</a></td>
- <td><code>@type torperf 1.0</code></td>
+ <td><code>@type torperf 1.1</code></td>
<td><a href="https://collector.torproject.org/recent/torperf/"; target="_blank" class="btn btn-primary btn-xs pull-left"><i class="fa fa-chevron-right" aria-hidden="true"></i> recent</a>
<a href="https://collector.torproject.org/archive/torperf/"; target="_blank" class="btn btn-primary btn-xs pull-right"><i class="fa fa-chevron-right" aria-hidden="true"></i> archive</a></td>
</tr>
@@ -679,38 +679,38 @@ ExitAddress 91.102.152.227 2010-12-28 10:35:30
</pre>
<br>
-<h2 id="torperf" class="hover">Torperf's Performance Data
+<h2 id="torperf" class="hover">Torperf's and OnionPerf's Performance Data
<a href="#torperf" class="anchor">#</a>
</h2>
<p>
-The performance measurement service Torperf publishes performance data
+The performance measurement services Torperf and OnionPerf publish performance data
from making simple HTTP requests over the Tor network.
-Torperf uses a trivial SOCKS client to download files of various sizes
+Torperf/OnionPerf use a SOCKS client to download files of various sizes
over the Tor network and notes how long substeps take.
</p>
-<h3 id="type-torperf" class="hover">Torperf Measurement Results
-<small><code>@type torperf 1.0</code></small>
+<h3 id="type-torperf" class="hover">Torperf and OnionPerf Measurement Results
+<small><code>@type torperf 1.1</code></small>
<a href="https://collector.torproject.org/recent/torperf/"; target="_blank" class="btn btn-primary btn-xs"><i class="fa fa-chevron-right" aria-hidden="true"></i> recent</a>
<a href="https://collector.torproject.org/archive/torperf/"; target="_blank" class="btn btn-primary btn-xs"><i class="fa fa-chevron-right" aria-hidden="true"></i> archive</a>
<a href="#type-torperf" class="anchor">#</a>
</h3>
<p>
-A Torperf results file contains a single line per Torperf run with
+A Torperf or OnionPerf results file contains a single line per Torperf/OnionPerf run with
<code>key=value</code> pairs.
-Such a result line is sufficient to learn about 1) the Tor and Torperf
+Such a result line is sufficient to learn about 1) the Tor and Torperf/OnionPerf
configuration, 2) measurement results, and 3) additional information that
might help explain the results.
-Known keys are explained below.
+Known keys in <code>@type torperf 1.0</code> are explained below.
</p>
<ul>
<li>Configuration
<ul>
<li><code>SOURCE:</code> Configured name of the data source; required.</li>
<li><code>FILESIZE:</code> Configured file size in bytes; required.</li>
-<li>Other meta data describing the Tor or Torperf configuration, e.g.,
+<li>Other meta data describing the Tor or Torperf/OnionPerf configuration, e.g.,
GUARD for a custom guard choice; optional.</li>
</ul></li>
<li>Measurement results
@@ -759,14 +759,15 @@ measurement; optional.</li>
</ul></li>
</ul>
-<p>
-Recently published Torperf measurement result files accumulate
-all new Torperf measurements of a given day, which means that
-they may change throughout the day.
-This is different from some of the other recently published files provided here
-which do not change once they are
-written.
-</p>
+<p>OnionPerf adds a few more keys in <code>@type torperf 1.1</code>:</p>
+<ul>
+<li><code>ENDPOINTLOCAL:</code> Hostname, IP address, and port that the TGen client used to connect to the local tor SOCKS port, formatted as <code>hostname:ip:port</code>, which may be <code>"NULL:0.0.0.0:0"</code> if TGen was not able to find this information; optional.</li>
+<li><code>ENDPOINTPROXY:</code> Hostname, IP address, and port that the TGen client used to connect to the SOCKS proxy server that tor runs, formatted as <code>hostname:ip:port</code>, which may be <code>"NULL:0.0.0.0:0"</code> if TGen was not able to find this information; optional.</li>
+<li><code>ENDPOINTREMOTE:</code> Hostname, IP address, and port that the TGen client used to connect to the remote server, formatted as <code>hostname:ip:port</code>, which may be <code>"NULL:0.0.0.0:0"</code> if TGen was not able to find this information; optional.</li>
+<li><code>HOSTNAMELOCAL:</code> Client machine hostname, which may be <code>"(NULL)"</code> if the TGen client was not able to find this information; optional.</li>
+<li><code>HOSTNAMEREMOTE:</code> Server machine hostname, which may be <code>"(NULL)"</code> if the TGen server was not able to find this information; optional.</li>
+<li><code>SOURCEADDRESS:</code> Public IP address of the OnionPerf host obtained by connecting to well-known servers and finding the IP address in the result, which may be <code>"unknown"</code> if OnionPerf was not able to find this information; optional.</li>
+</ul>
</div>
_______________________________________________
tor-commits mailing list
tor-commits@xxxxxxxxxxxxxxxxxxxx
https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-commits