[tor-commits] [metrics-web/master] Explain onion service traffic graphs a bit better.

[karsten at torproject.org]

commit 5cbb25ee575a0b58493f5bd4d5675eb7409589a9
Author: Karsten Loesing <karsten.loesing at gmx.net>
Date:   Mon Jan 20 11:56:21 2020 +0100

    Explain onion service traffic graphs a bit better.
    
    As discussed on the ticket, we can explain better which cells are
    counted for onion service traffic graphs: it's cells relayed by
    rendezvous points.
    
    It was also confusing to say "per day" in the graph description when
    bandwidth is in gigabits per second. Removed that part.
    
    Finally, there's now a glossary entry for "rendezvous points" that is
    based on the glossary entry in torspec.
    
    Fixes #26171.
---
 src/main/resources/web/json/metrics.json | 2 +-
 src/main/resources/web/jsps/glossary.jsp | 5 +++++
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/src/main/resources/web/json/metrics.json b/src/main/resources/web/json/metrics.json
index b8921c7..be40bdc 100644
--- a/src/main/resources/web/json/metrics.json
+++ b/src/main/resources/web/json/metrics.json
@@ -357,7 +357,7 @@
     "id": "hidserv-rend-relayed-cells",
     "title": "Onion-service traffic (versions 2 and 3)",
     "type": "Graph",
-    "description": "<p>This graph shows the amount of onion-service traffic from version 2 and version 3 onion services in the network per day.  This number is extrapolated from aggregated statistics on onion-service traffic reported by single <a href=\"glossary.html#relay\">relays</a> acting as rendezvous points for version 2 and 3 <a href=\"glossary.html#onion-service\">onion services</a>, if at least 1% of relays reported these statistics.  For more details on the extrapolation algorithm, see <a href=\"https://blog.torproject.org/blog/some-statistics-about-onions\">this blog post</a> and <a href=\"https://research.torproject.org/techreports/extrapolating-hidserv-stats-2015-01-31.pdf\">this technical report</a>.</p>",
+    "description": "<p>This graph shows the amount of onion-service traffic from version 2 and version 3 onion services relayed by <a href=\"glossary.html#rendezvous-point\">rendezvous points</a>.  This number is extrapolated from aggregated statistics on onion-service traffic reported by single <a href=\"glossary.html#relay\">relays</a> acting as <a href=\"glossary.html#rendezvous-point\">rendezvous points</a> for version 2 and 3 <a href=\"glossary.html#onion-service\">onion services</a>, if at least 1% of relays reported these statistics.  For more details on the extrapolation algorithm, see <a href=\"https://blog.torproject.org/blog/some-statistics-about-onions\">this blog post</a> and <a href=\"https://research.torproject.org/techreports/extrapolating-hidserv-stats-2015-01-31.pdf\">this technical report</a>.</p>",
     "function": "hidserv_rend_relayed_cells",
     "parameters": [
       "start",
diff --git a/src/main/resources/web/jsps/glossary.jsp b/src/main/resources/web/jsps/glossary.jsp
index 27f658e..b508c53 100644
--- a/src/main/resources/web/jsps/glossary.jsp
+++ b/src/main/resources/web/jsps/glossary.jsp
@@ -106,6 +106,11 @@
       <a href="https://gitweb.torproject.org/torspec.git/tree/dir-spec.txt" target="_blank">directory
       protocol specification</a>.</p>
 
+      <p id="rendezvous-point"><b><a href="#rendezvous-point">rendezvous
+      point:</a></b> a relay connecting a client to an onion service, where each
+      party builds a three-hop circuit, meeting at the rendezvous
+      point.</p>
+
     </div>
 
 <jsp:include page="bottom.jsp"/>