[tor-bugs] #15177 [Onionoo]: Add fractional times of relays having flags assigned to them to uptime documents

[Tor Bug Tracker & Wiki]

#15177: Add fractional times of relays having flags assigned to them to uptime
documents
-------------------------+---------------------
 Reporter:  karsten      |          Owner:
     Type:  enhancement  |         Status:  new
 Priority:  normal       |      Milestone:
Component:  Onionoo      |        Version:
 Keywords:               |  Actual Points:
Parent ID:               |         Points:
-------------------------+---------------------
 weasel considers querying Onionoo to put together a list of fallback
 directories that clients shall use in their bootstrap process instead of
 the directory authorities.  Requirements for these fallback directories
 include (but are not limited to):
  - have been Running in at least 99% of consensuses in the last 4 months
 and
  - have had the Guard flag assigned in at least 90% of consensuses.

 The "Running" part already exists with the uptime documents, and I wonder
 if we should extend that towards listing what fraction of a relay's uptime
 that relay had flags assigned.  See the `"flags"` part in the following
 example:

 {{{
 {
     "version": "2.2",
     "relays_published": "2015-03-06 11:00:00",
     "relays": [
         {
             "fingerprint": "847B1F850344D7876491A54892F904934E4EB85D",
             "uptime": {
                 "3_months": {
                     "first": "2014-12-04 06:00:00",
                     "last": "2015-03-06 06:00:00",
                     "interval": 43200,
                     "factor": 0.001001001001001001,
                     "count": 185,
                     "values": [
                         999,
                         999,
                         999,
                         ...
                         999,
                         999,
                         999
                     ],
                     "flags": {
                         "Authority": 1.0,
                         "HSDir": 0.998,
                         "Running": 1.0,
                         "Stable": 1.0,
                         "V2Dir": 1.0,
                         "Valid": 1.0
                     }
                 }
             }
         }
     ]
 }
 }}}

 This `"flags"` field would say that the relay had the Guard flag in 100%
 of consensuses known between 2014-12-04 06:00:00 and 2015-03-06 06:00:00.
 While that's 3 months, not 4, this might be close enough as requirements
 for a fallback directory.

 Similarly, the fraction of the relay having the Running flag could be
 looked up there, rather than computing the average of `"values"` and
 multiplying the result with `"factor"`.

 weasel, would this help?

--
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/15177>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online