[tor-commits] [torspec/master] dir-spec: Add "stats" line to a vote

[nickm at torproject.org]

commit 2169b637dd0ee4fef9bc28f0115349b10ea0b2b4
Author: David Goulet <dgoulet at torproject.org>
Date:   Wed Mar 10 09:52:08 2021 -0500

    dir-spec: Add "stats" line to a vote
    
    Signed-off-by: David Goulet <dgoulet at torproject.org>
---
 dir-spec.txt | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/dir-spec.txt b/dir-spec.txt
index 657e95f..d486991 100644
--- a/dir-spec.txt
+++ b/dir-spec.txt
@@ -2294,6 +2294,24 @@
      "id" SP "ed25519" SP "none" NL
         [vote only, at most once]
 
+     "stats" SP [KeyValues] NL
+
+        [At most once. Vote only]
+
+        KeyValue ::= Keyword '=' Number
+        Number ::= [0-9]+("."[0-9]+)?
+        KeyValues ::= KeyValue | KeyValues SP KeyValue
+
+        Line containing various statistics that an authority has computed for
+        this relay. Each stats is represented as a key + value. Reported keys
+        are:
+
+          "wfu"  - Weighted Fractional Uptime
+          "tk"   - Weighted Time Known
+          "mtbf" - Mean Time Between Failure (stability)
+
+          (As of tor-0.4.6.1-alpha)
+
    The footer section is delineated in all votes and consensuses supporting
    consensus method 9 and above with the following: