[metrics-bugs] #29461 [Metrics/CollecTor]: Add a Snowflake module

[Tor Bug Tracker & Wiki]

#29461: Add a Snowflake module
-------------------------------------------------+-------------------------
 Reporter:  irl                                  |          Owner:
                                                 |  metrics-team
     Type:  enhancement                          |         Status:
                                                 |  needs_information
 Priority:  Medium                               |      Milestone:
Component:  Metrics/CollecTor                    |        Version:
 Severity:  Normal                               |     Resolution:
 Keywords:  metrics-roadmap-august, anti-        |  Actual Points:
  censorship-roadmap-september                   |
Parent ID:                                       |         Points:  8
 Reviewer:  irl                                  |        Sponsor:
                                                 |  Sponsor28
-------------------------------------------------+-------------------------

Comment (by cohosh):

 Replying to [comment:25 karsten]:
 > Replying to [comment:24 cohosh]:
 > > Replying to [comment:22 cohosh]:
 > > > Replying to [comment:19 karsten]:
 > > > > cohosh, are you still planning to revise the spec and code to
 include such a `snowflake-stats $version` line?
 > > >
 > > > Yes, I just got back from vacation and I'm going to implement it
 this afternoon.
 > >
 > > Opened #31493 and implemented
 [https://github.com/cohosh/snowflake/compare/bug31493 here]. How does that
 look to you?
 >
 > Well, that would work, though I think that introducing a separate line
 for descriptor type and version might be clearer:
 >
 > {{{
 > snowflake-stats 1.0
 > snowflake-stats-end 2019-08-07 19:52:11 (86400 s)
 > snowflake-ips VN=5,NL=26,AU=30,GT=2,NO=5,EG=3,NI=1,AT=22,[...]
 > snowflake-ips-total 937
 > snowflake-idle-count 660976
 > client-denied-count 0
 > client-snowflake-match-count 864
 > }}}
 >
 > If this looks okay to you and if you make this change, do you think you
 could somehow edit the existing stats file on the snowflake broker, maybe
 using some `sed`/`awk` magic?

 I can do that, yes. dcf just commented that it might be easier to do the
 version on a separate line (see
 https://trac.torproject.org/projects/tor/ticket/31493#comment:3). Do you
 have an opinion on that? We're looking for ease of use now and in the
 future if/when the version bumps.

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