DOCS-906

Author: Sam Kleinman

source/administration/monitoring.txt

@@ -49,17 +49,17 @@ statistics about instances' performance and activity quickly. These
 are typically most useful for diagnosing issues and assessing normal
 operation.
 
-:program:`mongotop`
-```````````````````
+``mongotop``
+````````````
 
 :program:`mongotop` tracks and reports the current read and write
 activity of a MongoDB instance. :program:`mongotop` provides
 per-collection visibility into use. Use :program:`mongotop` to verify
 that activity and use match expectations. See the :doc:`mongotop
 manual </reference/mongotop>` for details.
 
-:program:`mongostat`
-````````````````````
+``mongostat``
+`````````````
 
 :program:`mongostat` captures and returns counters of database
 operations. :program:`mongostat` reports operations on a per-type
@@ -85,15 +85,15 @@ locally running mongod instance: http://localhost:28017
 Statistics
 ~~~~~~~~~~
 
-The :program:`mongo` shell provides a number of commands that return
+MongoDB provides a number of commands that return
 statistics about the state of the MongoDB instance. These data may
 provide finer granularity regarding the state of the MongoDB instance
 than the tools above. Consider using their output in scripts and
 programs to develop custom alerts, or modifying the behavior of your
 application in response to the activity of your instance.
 
-serverStatus
-````````````
+``serverStatus``
+````````````````
 
 Access :doc:`serverStatus data </reference/server-status/>` by way of
 the :dbcommand:`serverStatus` command. This :term:`document`
@@ -109,8 +109,8 @@ data provided by :dbcommand:`serverStatus`.
 .. seealso:: :method:`db.stats()` and :doc:`serverStatus data
    </reference/server-status/>`.
 
-replSetGetStatus
-````````````````
+``replSetGetStatus``
+````````````````````
 
 View the :doc:`replSetGetStatus data </reference/replica-status>` with
 the :dbcommand:`replSetGetStatus` command (:method:`rs.status()` from the
@@ -120,8 +120,8 @@ set. Use this data to ensure that replication is properly configured,
 and to check the connections between the current host and the members
 of the replica set.
 
-dbStats
-```````
+``dbStats``
+```````````
 
 The :doc:`dbStats data </reference/database-statistics>` is accessible
 by way of the :dbcommand:`dbStats` command (:method:`db.stats()` from
@@ -133,8 +133,8 @@ of a specific database. This output also allows you to compare
 utilization between databases and to determine average
 :term:`document` size in a database.
 
-collStats
-`````````
+``collStats``
+`````````````
 
 The :doc:`collStats data </reference/collection-statistics>` is
 accessible using the :dbcommand:`collStats` command (:method:`db.printCollectionStats()`
@@ -144,6 +144,19 @@ this includes a count of the objects in the collection, the size of
 the collection, the amount of disk space used by the collection, and
 information about the indexes.
 
+Introspection Tools
+-------------------
+
+In addition to status reporting, MongoDB provides a number of
+introspection tools that you can use to diagnose and analyze
+performance and operational conditions. Consider the following
+documentation:
+
+- :dbcommand:`diagLogging`
+- :doc:`/tutorial/manage-the-database-profiler`
+- :doc:`/reference/database-profiler`
+- :doc:`/reference/current-op`
+
 Third Party Tools
 ~~~~~~~~~~~~~~~~~