Skip to content

Commit 24c2ff5

Browse files
committed
DOCS-4522: mongotop 2.8 replset changes
- Updates ticket scope to actually only report on new error messaging, since behaviour has not changed from 2.6 -> 2.8.
1 parent a565c67 commit 24c2ff5

File tree

2 files changed

+18
-47
lines changed

2 files changed

+18
-47
lines changed

source/includes/options-mongotop.yaml

Lines changed: 10 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -37,16 +37,8 @@ inherit:
3737
program: _shared
3838
file: options-shared.yaml
3939
post: |
40-
41-
42-
.. versionchanged:: 2.8.0
43-
If connected to a replica set, {{program}} only reports activity
44-
on the :term:`primary`. {{program}} will not include activity on
45-
the :term:`secondaries <secondary>`.
46-
If the :term:`primary` is not reachable, {{program}} returns an
47-
error message. See:
48-
:ref:`Use with Replica Sets <mongotop-use-replicasets>`
49-
for more information.
40+
If connected to a replica set where the :term:`primary` is not
41+
reachable, {{program}} returns an error message.
5042
---
5143
program: mongotop
5244
name: port
@@ -139,8 +131,11 @@ inherit:
139131
program: _shared
140132
file: options-shared.yaml
141133
post: |
142-
{{role}} is required for :program:`mongod`
143-
and :program:`mongos` instances that use :ref:`authentication`.
134+
135+
136+
.. versionchanged:: 2.8.0
137+
{{role}} is required for :program:`mongod`
138+
and :program:`mongos` instances that use :ref:`authentication`.
144139
---
145140
program: mongotop
146141
name: authenticationMechanism
@@ -178,6 +173,9 @@ description: |
178173
Toggles the mode of :program:`mongotop` to report on use of per-database
179174
:ref:`locks <locks>`. These data are useful for measuring concurrent
180175
operations and lock percentage.
176+
post: |
177+
{{role}} returns an error when called against a :program:`mongod` instance
178+
that does not report lock usage.
181179
optional: true
182180
---
183181
program: mongotop

source/reference/program/mongotop.txt

Lines changed: 8 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -198,6 +198,11 @@ This command produces the following output:
198198
local.system.namespaces 0ms 0ms 0ms
199199
local.system.replset 0ms 0ms 0ms
200200

201+
The output varies depending on your MongoDB setup. For example,
202+
``local.system.indexes`` and ``local.system.namespaces`` only appears
203+
for :program:`mongod` instances using the :ref:`MMAPv1 <storage-mmapv1>`
204+
storage engine.
205+
201206
To return a :program:`mongotop` report every 5 minutes, use the
202207
following command:
203208

@@ -218,39 +223,7 @@ which produces the following output:
218223
admin 0ms 0ms 0ms
219224
. 0ms 0ms 0ms
220225

221-
.. _mongotop-use-replicasets:
222-
223226
.. versionchanged:: 2.8.0
224-
When connected to a replica set, :program:`mongotop` only reports activity
225-
on the :term:`primary`. :program:`mongotop` will not include activity on
226-
the :term:`secondaries <secondary>`.
227-
228-
If the :term:`primary` is not reachable or no members of the seed list
229-
are part of the specified replica set, :program:`mongotop` returns an
230-
error, as in the following output:
231-
232-
.. code-block:: sh
233-
234-
ns total read write 2014-12-19T15:31:45-05:00
235-
admin.system.roles 0ms 0ms 0ms
236-
admin.system.version 0ms 0ms 0ms
237-
local.me 0ms 0ms 0ms
238-
local.oplog.rs 0ms 0ms 0ms
239-
local.replset.minvalid 0ms 0ms 0ms
240-
local.startup_log 0ms 0ms 0ms
241-
local.system.replset 0ms 0ms 0ms
242-
243-
2014-12-19T15:31:51.824-0500 Error: no reachable servers
244-
245-
2014-12-19T15:31:57.834-0500 Error: no reachable servers
246-
247-
ns total read write 2014-12-19T15:32:01-05:00
248-
admin.system.roles 0ms 0ms 0ms
249-
admin.system.version 0ms 0ms 0ms
250-
local.me 0ms 0ms 0ms
251-
local.oplog.rs 0ms 0ms 0ms
252-
local.replset.minvalid 0ms 0ms 0ms
253-
local.startup_log 0ms 0ms 0ms
254-
local.system.indexes 0ms 0ms 0ms
255-
local.system.namespaces 0ms 0ms 0ms
256-
local.system.replset 0ms 0ms 0ms
227+
When called against a :program:`mongod` that does not report lock
228+
usage, :option:`--locks` will return a ``Failed: Server does not
229+
support reporting locking information`` error.

0 commit comments

Comments
 (0)