BIND 10 #170: document how stats are collected (via spec files)

[BIND 10 Development]

#170: document how stats are collected (via spec files)
-----------------------------+----------------------------------------------
      Reporter:  larissas    |        Owner:  jinmei                     
          Type:  task        |       Status:  reviewing                  
      Priority:  major       |    Milestone:  06. 4th Incremental Release
     Component:  statistics  |   Resolution:                             
      Keywords:              |    Sensitive:  0                          
Estimatedhours:  0.0         |        Hours:  1                          
      Billable:  0           |   Totalhours:  0.62                       
      Internal:  0           |  
-----------------------------+----------------------------------------------
Changes (by naokikambe):

  * hours:  0.0 => 1.0
  * owner:  naokikambe => jinmei
  * totalhours:  0.62 => 1.62


Comment:

 Replying to [comment:25 jinmei]:
 > I personally still think it's better to have the receiver keep the state
 (e.g. a list of senders) because the sender (which is most typically some
 DNS server module) would tend to be pretty complicated without this and it
 would make sense to keep it as simple as possible. But I understand this
 may be a matter of opinion.
 >
 > In any case, I'd suggest a minimalist approach: begin with "total" only,
 and when we see the real need where ''increase'' can be a choice we should
 discuss whether that's the best approach.
 >

 Yes, I love simplest model too. :)
 As you mentioned, ''increase'' command may be unsuitable for the auth
 module. But I cannot consider that deeply now. :(

 In the initial version of stats module, only two modules which are auth
 and boss module are talk with the stats module and they don't need this
 command now. So it's no problem if we disable this command now. We do
 this. That is,

  - Stats module handles only total counts. It never handles incremental
 counts.

  - So we remove ''increase'' command from both the document StatsModule
 and the implement #191. However if in the future this command is required,
 we'll consider it again.

 > For the design documentation, I'd suggest we leave it open, describing
 > these discussion points.
 If this conclusion is agreed, I'll close #170. If we consider that again,
 we'll open another ticket.

 Is that OK? Please let me know.

-- 
Ticket URL: <https://bind10.isc.org/ticket/170#comment:26>
BIND 10 Development <http://bind10.isc.org>
BIND 10 Development