dbStats (Database Statistics)
Last updated: 2026-10-09
dbStats (Database Statistics)
dbStats returns current-database statistics — collection count, document count, data size, index size, storage usage — for capacity planning and monitoring. In mongosh use db.stats() or db.runCommand({ dbStats: 1 }). The scale argument sets byte units (1024 for KB). On sharded clusters it returns aggregated figures.
| Category | Monitoring & Diagnostics |
|---|---|
| MongoDB Version | 1.0+ |
| Example Language | mongosh (Shell) |
📝 Syntax
db.stats()
db.runCommand({ dbStats: 1, scale: 1024 })⚙️ Parameters
| scale | Byte unit factor; 1024 means kilobytes |
|---|
Returns：A stats document: db, collections, objects, dataSize, storageSize, indexSize, ok, and more
▶ Example
Run the commands below in your local mongosh (requires a running mongod):
// dbStats: database statistics
use shop
db.runCommand({ dbStats: 1, scale: 1024 })Output：
{
db: 'shop',
collections: 5,
objects: 1200,
avgObjSize: 402,
dataSize: 482,
storageSize: 1024,
indexes: 7,
indexSize: 341,
ok: 1
}📌 Notes
- scale sets the unit (1024 for KB)
- dataSize is logical; storageSize is actual disk usage
- Sharded clusters return aggregated numbers
🏷️ Related Tags
💡 Related Cases
More hands-on cases coming soon.
📚 Related Tutorials
❓ FAQ
QdbStats vs collStats?
AdbStats aggregates at the database level; collStats targets one collection.
QHow do dataSize and storageSize differ?
AdataSize is logical document size; storageSize is disk usage including free space and compression.
QHow do I change the units?
APass scale: 1024 for KB; omit it for bytes.
