---
id: e18a2be1-653d-47eb-8929-d447c0621b49
---

# MongoDB document size limits reached.
---

This incident type relates to the situation where the limit of the document size in a MongoDB database has been exceeded. MongoDB is a type of NoSQL database that stores data in a document format, and each document has a defined size limit. When this limit is reached, it can cause issues with data storage and retrieval, potentially leading to system downtime or data loss.

### Parameters
```shell
export DATABASE_NAME="PLACEHOLDER"

export COLLECTION_NAME="PLACEHOLDER"

export MAX_SIZE="PLACEHOLDER"

export MONGODB_CONF_FILE="PLACEHOLDER"

export NEW_LIMIT="PLACEHOLDER"
```

## Debug

### 1. Check the current size of the MongoDB document
```shell
mongo ${DATABASE_NAME} --eval "db.${COLLECTION_NAME}.stats().size"
```

### 2. Check the maximum document size for the MongoDB version being used
```shell
mongo ${DATABASE_NAME} --eval "db.${COLLECTION_NAME}.getMongo().getDB('admin').runCommand({getParameter: 1, maxBsonObjectSize: 1})"
```

### 3. Check the size of the largest document in the MongoDB collection
```shell
mongo ${DATABASE_NAME} --eval "db.${COLLECTION_NAME}.find().sort({$natural:-1}).limit(1).explain().executionStats.allPlansExecution[0].winningPlan"
```

### 4. Check for any indexes that may be causing the document size limit to be reached
```shell
mongo ${DATABASE_NAME} --eval "db.${COLLECTION_NAME}.getIndexes()"
```

### 5. Check for any documents that may be exceeding the size limit
```shell
mongo ${DATABASE_NAME} --eval "db.${COLLECTION_NAME}.find({$where: 'Object.bsonsize(this) >= ${MAX_SIZE}'})"
```

### 6. Check for any MongoDB configuration settings that may be impacting the document size limit
```shell
cat /etc/mongod.conf
```

## Repair

### Increase the document size limit in MongoDB configuration.
```shell


#!/bin/bash



# Set the variables

DB_NAME=${DATABASE_NAME}

CONF_FILE=${MONGODB_CONF_FILE}

NEW_LIMIT=${NEW_LIMIT}



# Stop the MongoDB service

sudo service mongod stop



# Update the configuration file with the new limit

sudo sed -i "s/$documentSizeLimitGB\s*=\s*$.*\$/\1$NEW_LIMIT/" $CONF_FILE



# Start the MongoDB service

sudo service mongod start


```

This incident type relates to the situation where the limit of the document size in a MongoDB database has been exceeded. MongoDB is a type of NoSQL database that stores data in a document format, and each document has a defined size limit. When this limit is reached, it can cause issues with data storage and retrieval, potentially leading to system downtime or data loss.


```shell
export DATABASE_NAME="PLACEHOLDER"

export COLLECTION_NAME="PLACEHOLDER"

export MAX_SIZE="PLACEHOLDER"

export MONGODB_CONF_FILE="PLACEHOLDER"

export NEW_LIMIT="PLACEHOLDER"
```


### 1. Check the current size of the MongoDB document

```shell
mongo ${DATABASE_NAME} --eval "db.${COLLECTION_NAME}.stats().size"
```

### 2. Check the maximum document size for the MongoDB version being used

```shell
mongo ${DATABASE_NAME} --eval "db.${COLLECTION_NAME}.getMongo().getDB('admin').runCommand({getParameter: 1, maxBsonObjectSize: 1})"
```

### 3. Check the size of the largest document in the MongoDB collection

```shell
mongo ${DATABASE_NAME} --eval "db.${COLLECTION_NAME}.find().sort({$natural:-1}).limit(1).explain().executionStats.allPlansExecution[0].winningPlan"
```

### 4. Check for any indexes that may be causing the document size limit to be reached

```shell
mongo ${DATABASE_NAME} --eval "db.${COLLECTION_NAME}.getIndexes()"
```

### 5. Check for any documents that may be exceeding the size limit

```shell
mongo ${DATABASE_NAME} --eval "db.${COLLECTION_NAME}.find({$where: 'Object.bsonsize(this) >= ${MAX_SIZE}'})"
```

### 6. Check for any MongoDB configuration settings that may be impacting the document size limit

```shell
cat /etc/mongod.conf
```


### Increase the document size limit in MongoDB configuration.

```shell


#!/bin/bash



# Set the variables

DB_NAME=${DATABASE_NAME}

CONF_FILE=${MONGODB_CONF_FILE}

NEW_LIMIT=${NEW_LIMIT}



# Stop the MongoDB service

sudo service mongod stop



# Update the configuration file with the new limit

sudo sed -i "s/$documentSizeLimitGB\s*=\s*$.*\$/\1$NEW_LIMIT/" $CONF_FILE



# Start the MongoDB service

sudo service mongod start


```


MongoDB document size limits reached.

Overview

Parameters

Debug

1. Check the current size of the MongoDB document

2. Check the maximum document size for the MongoDB version being used

3. Check the size of the largest document in the MongoDB collection

4. Check for any indexes that may be causing the document size limit to be reached

5. Check for any documents that may be exceeding the size limit

6. Check for any MongoDB configuration settings that may be impacting the document size limit

Repair

Increase the document size limit in MongoDB configuration.

Learn more

Related Runbooks

Support