trafficserver-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From a..@apache.org
Subject trafficserver git commit: Doc: Update milestone man page for plugin milestones.
Date Fri, 26 Jun 2015 15:51:51 GMT
Repository: trafficserver
Updated Branches:
  refs/heads/master 4377dabd0 -> a3e83c11d


Doc: Update milestone man page for plugin milestones.


Project: http://git-wip-us.apache.org/repos/asf/trafficserver/repo
Commit: http://git-wip-us.apache.org/repos/asf/trafficserver/commit/a3e83c11
Tree: http://git-wip-us.apache.org/repos/asf/trafficserver/tree/a3e83c11
Diff: http://git-wip-us.apache.org/repos/asf/trafficserver/diff/a3e83c11

Branch: refs/heads/master
Commit: a3e83c11d6269666810a710ce4cb0bc5a69bad57
Parents: 4377dab
Author: Alan M. Carroll <solidwallofcode@yahoo-inc.com>
Authored: Fri Jun 26 10:51:27 2015 -0500
Committer: Alan M. Carroll <solidwallofcode@yahoo-inc.com>
Committed: Fri Jun 26 10:51:27 2015 -0500

----------------------------------------------------------------------
 doc/reference/api/TSHttpTxnMilestoneGet.en.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/trafficserver/blob/a3e83c11/doc/reference/api/TSHttpTxnMilestoneGet.en.rst
----------------------------------------------------------------------
diff --git a/doc/reference/api/TSHttpTxnMilestoneGet.en.rst b/doc/reference/api/TSHttpTxnMilestoneGet.en.rst
index 0e9f1ff..c2ee444 100644
--- a/doc/reference/api/TSHttpTxnMilestoneGet.en.rst
+++ b/doc/reference/api/TSHttpTxnMilestoneGet.en.rst
@@ -61,6 +61,8 @@ Value                                           Milestone
 :const:`TS_MILESTONE_DNS_LOOKUP_END`            Host resolution resolves.
 :const:`TS_MILESTONE_SM_START`                  Transaction state machine is initialized.
 :const:`TS_MILESTONE_SM_FINISH`                 Transaction has finished, state machine final
logging has started.
+:const:`TS_MILESTONE_PLUGIN_ACTIVE`             Amount of time plugins were active plus start
time.
+:const:`TS_MILESTONE_PLUGIN_TOTAL`              Wall time while plugins were active plus
start time.
 =============================================== ==========
 
 *  The server connect times predate the transmission of the ``SYN`` packet. That is, before
a connection to the
@@ -75,6 +77,16 @@ Value                                           Milestone
 
 *  The cache ``OPEN`` milestones time only the initial setup, the "open", not the full read
or write.
 
+*  :const:`TS_MILESTONE_PLUGIN_ACTIVE` and :const:`TS_MILESTONE_PLUGIN_TOTAL` are different
from the other milestones as
+   they measure elapsed time, not event time. The value is the elapsed time *plus* :const:`TS_MILESTONE_SM_START`.
This
+   was decided to be more convenient because then these milestones can be handled / displayed
in the same way as the
+   other milestones, as offsets from :const:`TS_MILESTONE_SM_START`.
+
+   :const:`TS_MILESTONE_PLUGIN_ACTIVE` value is the amount of time the plugin was active,
that is performing
+   computation. :const:`TS_MILESTONE_PLUGIN_TOTAL` is the wall time which includes any time
the transaction was blocked
+   while a plugin was active. For instance if a plugin waits on an external event, that waiting
time will be in
+   :const:`TS_MILESTONE_PLUGIN_TOTAL` but not in :const:`TS_MILESTONE_PLUGIN_ACTIVE`.
+
 Return values
 =============
 


Mime
View raw message