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:  shane                      
     Type:  task        |       Status:  reviewing                  
 Priority:  major       |    Milestone:  06. 4th Incremental Release
Component:  statistics  |   Resolution:                             
 Keywords:              |    Sensitive:  0                          
------------------------+---------------------------------------------------
Changes (by naokikambe):

  * owner:  naokikambe => shane


Comment:

 Replying to [comment:11 shane]:

 Thank you for your comment.

 >  This system supports "clearing" the statistics, which I think means
 >  setting them to 0. However, there is no information reporting about
 when
 >  or if this has been done. I think adding a timestamp to the values
 >  reported by the auth server and the boss process which is the time when
 >  statistics were cleared might be useful. This would be the start time
 of
 >  the process initially.

 I'll add description like this to this document:

 The stats module always reports "stats.!BootTime", "stats.!StartTime"
 and "stats.!LastUpdateTime. "stats.!BootTime" means the time when the
 stats module starts initially or the time when the stats module
 restarts. "stats.!StartTime" means the time when the stats module
 starts collecting data and aggregating values and the stats module
 doesn't reset the value of "stats.!StartTime" to current time until
 "clearing" command is done. "stats.!LastUpdateTime" means the latest
 time when another module like auth server or boss process reports to
 stats module.

 I think these reporting items is useful for identifying when or if
 "clearing" has been done.

 Is that OK? If OK, I'll revise this document, otherwise I welcome
 better idea than this.:)

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