1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
|
plugin_name: go.d.plugin
modules:
- meta:
id: collector-go.d.plugin-mongodb
plugin_name: go.d.plugin
module_name: mongodb
monitored_instance:
name: MongoDB
link: https://www.mongodb.com/
icon_filename: mongodb.svg
categories:
- data-collection.database-servers
keywords:
- mongodb
- databases
related_resources:
integrations:
list: []
info_provided_to_referring_integrations:
description: ""
most_popular: false
overview:
data_collection:
metrics_description: |
This collector monitors MongoDB servers.
Executed queries:
- [serverStatus](https://docs.mongodb.com/manual/reference/command/serverStatus/)
- [dbStats](https://docs.mongodb.com/manual/reference/command/dbStats/)
- [replSetGetStatus](https://www.mongodb.com/docs/manual/reference/command/replSetGetStatus/)
method_description: ""
supported_platforms:
include: []
exclude: []
multi_instance: true
additional_permissions:
description: ""
default_behavior:
auto_detection:
description: ""
limits:
description: ""
performance_impact:
description: ""
setup:
prerequisites:
list:
- title: Create a read-only user
description: |
Create a read-only user for Netdata in the admin database.
- Authenticate as the admin user:
```bash
use admin
db.auth("admin", "<MONGODB_ADMIN_PASSWORD>")
```
- Create a user:
```bash
db.createUser({
"user":"netdata",
"pwd": "<UNIQUE_PASSWORD>",
"roles" : [
{role: 'read', db: 'admin' },
{role: 'clusterMonitor', db: 'admin'},
{role: 'read', db: 'local' }
]
})
```
configuration:
file:
name: go.d/mongodb.conf
options:
description: |
The following options can be defined globally: update_every, autodetection_retry.
folding:
title: Config options
enabled: true
list:
- name: update_every
description: Data collection frequency.
default_value: 5
required: false
- name: autodetection_retry
description: Recheck interval in seconds. Zero means no recheck will be scheduled.
default_value: 0
required: false
- name: uri
description: MongoDB connection string. See [URI syntax](https://www.mongodb.com/docs/manual/reference/connection-string/).
default_value: mongodb://localhost:27017
required: true
- name: timeout
description: Query timeout in seconds.
default_value: 1
required: false
- name: databases
description: Databases selector. Determines which database metrics will be collected.
default_value: ""
required: false
details: |
Metrics of databases matching the selector will be collected.
- Logic: (pattern1 OR pattern2) AND !(pattern3 or pattern4)
- Pattern syntax: [matcher](https://github.com/netdata/netdata/tree/master/src/go/collectors/go.d.plugin/pkg/matcher#supported-format).
- Syntax:
```yaml
per_user_stats:
includes:
- pattern1
- pattern2
excludes:
- pattern3
- pattern4
```
examples:
folding:
title: Config
enabled: true
list:
- name: TCP socket
description: An example configuration.
config: |
jobs:
- name: local
uri: mongodb://netdata:password@localhost:27017
- name: With databases metrics
description: An example configuration.
config: |
jobs:
- name: local
uri: mongodb://netdata:password@localhost:27017
databases:
includes:
- "* *"
- name: Multi-instance
description: |
> **Note**: When you define multiple jobs, their names must be unique.
Local and remote instances.
config: |
jobs:
- name: local
uri: mongodb://netdata:password@localhost:27017
- name: remote
uri: mongodb://netdata:password@203.0.113.0:27017
troubleshooting:
problems:
list: []
alerts: []
metrics:
folding:
title: Metrics
enabled: false
availability: []
description: |
- WireTiger metrics are available only if [WiredTiger](https://docs.mongodb.com/v6.0/core/wiredtiger/) is used as the
storage engine.
- Sharding metrics are available on shards only
for [mongos](https://www.mongodb.com/docs/manual/reference/program/mongos/).
scopes:
- name: global
description: These metrics refer to the entire monitored application.
labels: []
metrics:
- name: mongodb.operations_rate
description: Operations rate
unit: operations/s
chart_type: line
dimensions:
- name: reads
- name: writes
- name: commands
- name: mongodb.operations_latency_time
description: Operations Latency
unit: milliseconds
chart_type: line
dimensions:
- name: reads
- name: writes
- name: commands
- name: mongodb.operations_by_type_rate
description: Operations by type
unit: operations/s
chart_type: line
dimensions:
- name: insert
- name: query
- name: update
- name: delete
- name: getmore
- name: command
- name: mongodb.document_operations_rate
description: Document operations
unit: operations/s
chart_type: stacked
dimensions:
- name: inserted
- name: deleted
- name: returned
- name: updated
- name: mongodb.scanned_indexes_rate
description: Scanned indexes
unit: indexes/s
chart_type: line
dimensions:
- name: scanned
- name: mongodb.scanned_documents_rate
description: Scanned documents
unit: documents/s
chart_type: line
dimensions:
- name: scanned
- name: mongodb.active_clients_count
description: Connected clients
unit: clients
chart_type: line
dimensions:
- name: readers
- name: writers
- name: mongodb.queued_operations_count
description: Queued operations because of a lock
unit: operations
chart_type: line
dimensions:
- name: reads
- name: writes
- name: mongodb.cursors_open_count
description: Open cursors
unit: cursors
chart_type: line
dimensions:
- name: open
- name: mongodb.cursors_open_no_timeout_count
description: Open cursors with disabled timeout
unit: cursors
chart_type: line
dimensions:
- name: open_no_timeout
- name: mongodb.cursors_opened_rate
description: Opened cursors rate
unit: cursors/s
chart_type: line
dimensions:
- name: opened
- name: mongodb.cursors_timed_out_rate
description: Timed-out cursors
unit: cursors/s
chart_type: line
dimensions:
- name: timed_out
- name: mongodb.cursors_by_lifespan_count
description: Cursors lifespan
unit: cursors
chart_type: stacked
dimensions:
- name: le_1s
- name: 1s_5s
- name: 5s_15s
- name: 15s_30s
- name: 30s_1m
- name: 1m_10m
- name: ge_10m
- name: mongodb.transactions_count
description: Current transactions
unit: transactions
chart_type: line
dimensions:
- name: active
- name: inactive
- name: open
- name: prepared
- name: mongodb.transactions_rate
description: Transactions rate
unit: transactions/s
chart_type: line
dimensions:
- name: started
- name: aborted
- name: committed
- name: prepared
- name: mongodb.connections_usage
description: Connections usage
unit: connections
chart_type: stacked
dimensions:
- name: available
- name: used
- name: mongodb.connections_by_state_count
description: Connections By State
unit: connections
chart_type: line
dimensions:
- name: active
- name: threaded
- name: exhaust_is_master
- name: exhaust_hello
- name: awaiting_topology_changes
- name: mongodb.connections_rate
description: Connections Rate
unit: connections/s
chart_type: line
dimensions:
- name: created
- name: mongodb.asserts_rate
description: Raised assertions
unit: asserts/s
chart_type: stacked
dimensions:
- name: regular
- name: warning
- name: msg
- name: user
- name: tripwire
- name: rollovers
- name: mongodb.network_traffic_rate
description: Network traffic
unit: bytes/s
chart_type: stacked
dimensions:
- name: in
- name: out
- name: mongodb.network_requests_rate
description: Network Requests
unit: requests/s
chart_type: line
dimensions:
- name: requests
- name: mongodb.network_slow_dns_resolutions_rate
description: Slow DNS resolution operations
unit: resolutions/s
chart_type: line
dimensions:
- name: slow_dns
- name: mongodb.network_slow_ssl_handshakes_rate
description: Slow SSL handshake operations
unit: handshakes/s
chart_type: line
dimensions:
- name: slow_ssl
- name: mongodb.memory_resident_size
description: Used resident memory
unit: bytes
chart_type: line
dimensions:
- name: used
- name: mongodb.memory_virtual_size
description: Used virtual memory
unit: bytes
chart_type: line
dimensions:
- name: used
- name: mongodb.memory_page_faults_rate
description: Memory page faults
unit: pgfaults/s
chart_type: line
dimensions:
- name: pgfaults
- name: mongodb.memory_tcmalloc_stats
description: TCMalloc statistics
unit: bytes
chart_type: line
dimensions:
- name: allocated
- name: central_cache_freelist
- name: transfer_cache_freelist
- name: thread_cache_freelists
- name: pageheap_freelist
- name: pageheap_unmapped
- name: mongodb.wiredtiger_concurrent_read_transactions_usage
description: Wired Tiger concurrent read transactions usage
unit: transactions
chart_type: stacked
dimensions:
- name: available
- name: used
- name: mongodb.wiredtiger_concurrent_write_transactions_usage
description: Wired Tiger concurrent write transactions usage
unit: transactions
chart_type: stacked
dimensions:
- name: available
- name: used
- name: mongodb.wiredtiger_cache_usage
description: Wired Tiger cache usage
unit: bytes
chart_type: line
dimensions:
- name: used
- name: mongodb.wiredtiger_cache_dirty_space_size
description: Wired Tiger cache dirty space size
unit: bytes
chart_type: line
dimensions:
- name: dirty
- name: mongodb.wiredtiger_cache_io_rate
description: Wired Tiger IO activity
unit: pages/s
chart_type: line
dimensions:
- name: read
- name: written
- name: mongodb.wiredtiger_cache_evictions_rate
description: Wired Tiger cache evictions
unit: pages/s
chart_type: stacked
dimensions:
- name: unmodified
- name: modified
- name: mongodb.sharding_nodes_count
description: Sharding Nodes
unit: nodes
chart_type: stacked
dimensions:
- name: shard_aware
- name: shard_unaware
- name: mongodb.sharding_sharded_databases_count
description: Sharded databases
unit: databases
chart_type: stacked
dimensions:
- name: partitioned
- name: unpartitioned
- name: mongodb.sharding_sharded_collections_count
description: Sharded collections
unit: collections
chart_type: stacked
dimensions:
- name: partitioned
- name: unpartitioned
- name: lock type
description: These metrics refer to the lock type.
labels:
- name: lock_type
description: lock type (e.g. global, database, collection, mutex)
metrics:
- name: mongodb.lock_acquisitions_rate
description: Lock acquisitions
unit: acquisitions/s
chart_type: line
dimensions:
- name: shared
- name: exclusive
- name: intent_shared
- name: intent_exclusive
- name: commit type
description: These metrics refer to the commit type.
labels:
- name: commit_type
description: commit type (e.g. noShards, singleShard, singleWriteShard)
metrics:
- name: mongodb.transactions_commits_rate
description: Transactions commits
unit: commits/s
chart_type: line
dimensions:
- name: success
- name: fail
- name: mongodb.transactions_commits_duration_time
description: Transactions successful commits duration
unit: milliseconds
chart_type: line
dimensions:
- name: commits
- name: database
description: These metrics refer to the database.
labels:
- name: database
description: database name
metrics:
- name: mongodb.database_collection_count
description: Database collections
unit: collections
chart_type: line
dimensions:
- name: collections
- name: mongodb.database_indexes_count
description: Database indexes
unit: indexes
chart_type: line
dimensions:
- name: indexes
- name: mongodb.database_views_count
description: Database views
unit: views
chart_type: line
dimensions:
- name: views
- name: mongodb.database_documents_count
description: Database documents
unit: documents
chart_type: line
dimensions:
- name: documents
- name: mongodb.database_data_size
description: Database data size
unit: bytes
chart_type: line
dimensions:
- name: data_size
- name: mongodb.database_storage_size
description: Database storage size
unit: bytes
chart_type: line
dimensions:
- name: storage_size
- name: mongodb.database_index_size
description: Database index size
unit: bytes
chart_type: line
dimensions:
- name: index_size
- name: replica set member
description: These metrics refer to the replica set member.
labels:
- name: repl_set_member
description: replica set member name
metrics:
- name: mongodb.repl_set_member_state
description: Replica Set member state
unit: state
chart_type: line
dimensions:
- name: primary
- name: startup
- name: secondary
- name: recovering
- name: startup2
- name: unknown
- name: arbiter
- name: down
- name: rollback
- name: removed
- name: mongodb.repl_set_member_health_status
description: Replica Set member health status
unit: status
chart_type: line
dimensions:
- name: up
- name: down
- name: mongodb.repl_set_member_replication_lag_time
description: Replica Set member replication lag
unit: milliseconds
chart_type: line
dimensions:
- name: replication_lag
- name: mongodb.repl_set_member_heartbeat_latency_time
description: Replica Set member heartbeat latency
unit: milliseconds
chart_type: line
dimensions:
- name: heartbeat_latency
- name: mongodb.repl_set_member_ping_rtt_time
description: Replica Set member ping RTT
unit: milliseconds
chart_type: line
dimensions:
- name: ping_rtt
- name: mongodb.repl_set_member_uptime
description: Replica Set member uptime
unit: seconds
chart_type: line
dimensions:
- name: uptime
- name: shard
description: These metrics refer to the shard.
labels:
- name: shard_id
description: shard id
metrics:
- name: mongodb.sharding_shard_chunks_count
description: Shard chunks
unit: chunks
chart_type: line
dimensions:
- name: chunks
|