DOCS-158 changes in response to technical review

Author: Sam Kleinman

source/reference/connection-pool-stats.txt

@@ -24,19 +24,19 @@ Output
 .. stats:: hosts
 
    The sub-documents of the :stats:`hosts` :term:`document` report connections
-   between the :program:`mongos` instance and every component
+   between the :program:`mongos` or :program:`mongod` instance and each component
    :program:`mongod` of the :term:`shard cluster`.
 
    .. stats:: hosts.[host].available
 
       :stats:`hosts.[host].available` reports the total number of
-      connections created by the :program:`mongos`, and used to
-      connect to members of the :term:`shard cluster`.
+      connections that the :program:`mongos` or :program:`mongod`
+      could use to connect to this :program:`mongod`.
 
    .. stats:: hosts.[host].created
 
       :stats:`hosts.[host].created` reports the number of connections
-      that this :program:`mongos` has ever created for this host.
+      that this :program:`mongos` or :program:`mongod` has ever created for this host.
 
 .. stats:: replicaSets
 
@@ -50,53 +50,63 @@ Output
 
    .. stats:: replicaSets.[shard].host
 
-      The :stats:`replicaSets.[shard].host` :term:`document` reports
-       on each host within the :term:`shard` in the :term:`replica
-       set`.
+      The :stats:`replicaSets.[shard].host` field holds an array of
+      :term:`document` that reports on each host within the
+      :term:`shard` in the :term:`replica set`.
 
       These values derive from the :doc:`replica set status
       </reference/replica-status>` values.
 
-      .. stats:: replicaSets.[shard].[host].addr
+      .. stats:: replicaSets.[shard].host[n].addr
 
-         :stats:`replicaSets.[shard].[host].addr` reports the address
+         :stats:`replicaSets.[shard].host[n].addr` reports the address
          for the host in the :term:`shard cluster` in the format of
          "``[hostname]:[port]``".
 
-      .. stats:: replicaSets.[shard].[host].ok
+      .. stats:: replicaSets.[shard].host[n].ok
 
-         :stats:`replicaSets.[shard].[host].ok` reports ``false``
+         :stats:`replicaSets.[shard].host[n].ok` reports ``false``
          when:
 
-         - the :program:`mongos` cannot connect to instance.
+         - the :program:`mongos` or :program:`mongod` cannot connect
+           to instance.
 
-         - the :program:`mongos` received a connection exception or error.
+         - the :program:`mongos` or :program:`mongod` received a
+           connection exception or error.
 
          This field is for internal use.
 
-      .. stats:: replicaSets.[shard].[host].ismaster
+      .. stats:: replicaSets.[shard].host[n].ismaster
 
-         :stats:`replicaSets.[shard].[host].ismaster` reports ``true``
+         :stats:`replicaSets.[shard].host[n].ismaster` reports ``true``
          if this :stats:`replicaSets.[shard].host` is the
          :term:`primary` member of the :term:`replica set`.
 
-      .. stats:: replicaSets.[shard].[host].hidden
+      .. stats:: replicaSets.[shard].host[n].hidden
 
-         :stats:`replicaSets.[shard].[host].hidden` reports ``true``
+         :stats:`replicaSets.[shard].host[n].hidden` reports ``true``
          if this :stats:`replicaSets.[shard].host` is a :term:`hidden
          member` of the :term:`replica set`.
 
-      .. stats:: replicaSets.[shard].[host].secondary
+      .. stats:: replicaSets.[shard].host[n].secondary
 
-         :stats:`replicaSets.[shard].[host].secondary` reports
+         :stats:`replicaSets.[shard].host[n].secondary` reports
          ``true`` if this :stats:`replicaSets.[shard].host` is a
          :term:`secondary` member of the :term:`replica set`.
 
-      .. stats:: replicaSets.[shard].[host].pingTimeMillis
+      .. stats:: replicaSets.[shard].host[n].pingTimeMillis
 
-         :stats:`replicaSets.[shard].[host].pingTimeMillis` reports
-         the ping time in milliseconds from the :program:`mongos` to
-         this :stats:`replicaSets.[shard].host`.
+         :stats:`replicaSets.[shard].host[n].pingTimeMillis` reports
+         the ping time in milliseconds from the :program:`mongos` or
+         :program:`mongod` to this :stats:`replicaSets.[shard].host`.
+
+      .. stats:: replicaSets.[shard].host[n].tags
+
+         .. versionadded:: 2.2
+
+         :stats:`replicaSets.[shard].host[n].tags` reports the
+         :data:`members[n].tags`, if this member of the set has tags
+         configured.
 
    .. stats:: replicaSets.[shard].master
 
@@ -115,7 +125,7 @@ Output
 .. stats:: createdByType
 
    :stats:`createdByType` :term:`document` reports the number of each
-   type of connection that :program:`mongos` has created in all
+   type of connection that :program:`mongos` or :program:`mongod` has created in all
    connection pools.
 
    :program:`mongos` connect to :program:`mongod` instances using one
@@ -141,25 +151,26 @@ Output
 .. stats:: totalAvailable
 
    :stats:`totalAvailable` reports the running total of connections
-   from the :program:`mongos` to all :program:`mongod` instances in
-   the :term:`shard cluster`
+   from the :program:`mongos` or :program:`mongod` to all :program:`mongod` instances in
+   the :term:`shard cluster` available for use. This value does not
+   reflect those connections that
 
 .. stats:: totalCreated
 
    :stats:`totalCreated` reports the total number of connections ever
-   created from the :program:`mongos` to all :program:`mongod`
+   created from the :program:`mongos` or :program:`mongod` to all :program:`mongod`
    instances in the :term:`shard cluster`.
 
 .. stats:: numDBClientConnection
 
    :stats:`numDBClientConnection` reports the total number of
-   connections from the :program:`mongos` to all of the :program:`mongod`
+   connections from the :program:`mongos` or :program:`mongod` to all of the :program:`mongod`
    instances in the :term:`shard cluster`.
 
 .. stats:: numAScopedConnection
 
    :stats:`numAScopedConnection` reports the number of exception safe
-   connections created from :program:`mongos` to all :program:`mongod`
-   in the :term:`shard cluster`. The :program:`mongos` releases these
+   connections created from :program:`mongos` or :program:`mongod` to all :program:`mongod`
+   in the :term:`shard cluster`. The :program:`mongos` or :program:`mongod` releases these
    connections after receiving a socket exception from the
    :program:`mongod`.