[metrics-bugs] #21414 [Metrics]: Should metrics web sites (metrics.tp.o, collector.tp.o, onionoo.tp.o) display currently running software version?

[Tor Bug Tracker & Wiki]

#21414: Should metrics web sites (metrics.tp.o, collector.tp.o, onionoo.tp.o)
display currently running software version?
-------------------------+------------------------------
 Reporter:  iwakeh       |          Owner:  metrics-team
     Type:  enhancement  |         Status:  new
 Priority:  Low          |      Milestone:
Component:  Metrics      |        Version:
 Severity:  Normal       |     Resolution:
 Keywords:               |  Actual Points:
Parent ID:               |         Points:
 Reviewer:               |        Sponsor:
-------------------------+------------------------------

Comment (by karsten):

 So, if we go ahead with #21551 and merge CollecTor and Onionoo sites into
 the Metrics website, we'll have to adapt this ticket a bit.  In that case
 it would still make sense for CollecTor and Onionoo to reveal the version
 they're running, just not on an HTML page:

  - CollecTor could include an `"implementation_version"` field in its
 `/index/index.json*` files.  That field could contain the same value that
 we're including as `Implementation-Version` in the build file, e.g.,
 `"1.1.2-ef96cf8"` for the latest release.

  - Onionoo could likewise include an `"implementation_version"` in the
 header of all its responses.  It already contains the protocol
 `"version"`, like `"4.0"`, but including something like `"1.2.0-4717532"`
 might turn out to be really helpful for debugging.  We should be careful
 with modifying the required `"version"` field though.

  - Metrics would not include a version number if we move forward with
 #21551, because we would continue with not putting out releases for it.
 But it might still make sense to put the Git commit (short, 7 characters)
 in the page footer.  After all, the graphs will remain part of Metrics,
 and knowing which exact version is deployed might make debugging easier.
 But that's really something that the average user wouldn't care about, so
 we should make it tiny.  Or we could even put it as comment into the page
 sources, except that we'd be the only ones knowing where to find it.
 Though maybe that's okay?

  - The new service discussed in #21551 for providing .csv files should
 include an implementation version, too.  Maybe it'll contain a machine-
 readable index file of some sort, too.

 The mirror topic depends a lot of #21551.  We should probably move forward
 with that discussion first.

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