---
id: c76d6346-feba-4d0d-9b14-d37bc515d4b8
---

# MongoDB instance down
---

This incident type refers to an issue where the MongoDB instance is down. This can cause disruption to any applications or services that rely on the database. It requires immediate attention from the appropriate personnel to diagnose and resolve the issue to minimize the impact on the affected systems.

### Parameters
```shell
# Environment Variables

export HOSTNAME="PLACEHOLDER"

export PORT="PLACEHOLDER"

export DATABASE="PLACEHOLDER"

export COLLECTION="PLACEHOLDER"

export INSTANCE_NAME="PLACEHOLDER"

export MONGODB_DATA_DIRECTORY="PLACEHOLDER"
```

## Debug

### Check if MongoDB is running
```shell
systemctl status mongodb
```

### Check MongoDB logs for errors
```shell
journalctl -u mongodb | grep ERROR
```

### Check MongoDB connectivity
```shell
mongo ${HOSTNAME}:${PORT}
```

### Check MongoDB database status
```shell
mongo ${HOSTNAME}:${PORT}/${DATABASE} --eval "db.stats()"
```

### Check MongoDB collection status
```shell
mongo ${HOSTNAME}:${PORT}/${DATABASE} --eval "db.${COLLECTION}.stats()"
```

### Check MongoDB process usage
```shell
top -p $(pgrep -d',' mongod)
```

### Check MongoDB disk usage
```shell
df -h ${MONGODB_DATA_DIRECTORY}
```

## Repair

### Define the affected MongoDB instance
```shell
INSTANCE=${INSTANCE_NAME}
```

### Restart the MongoDB service
```shell
sudo systemctl restart mongodb.service
```

### Check the status of the MongoDB service
```shell
STATUS=$(sudo systemctl status mongodb.service | grep "Active:" | awk '{print $2}')
```

### Check if the service has started successfully
```shell
if [ "$STATUS" == "active" ]; then

    echo "MongoDB service has been restarted successfully."

else

    echo "Failed to restart MongoDB service."

fi
```

This incident type refers to an issue where the MongoDB instance is down. This can cause disruption to any applications or services that rely on the database. It requires immediate attention from the appropriate personnel to diagnose and resolve the issue to minimize the impact on the affected systems.


```shell
# Environment Variables

export HOSTNAME="PLACEHOLDER"

export PORT="PLACEHOLDER"

export DATABASE="PLACEHOLDER"

export COLLECTION="PLACEHOLDER"

export INSTANCE_NAME="PLACEHOLDER"

export MONGODB_DATA_DIRECTORY="PLACEHOLDER"
```


### Check if MongoDB is running

```shell
systemctl status mongodb
```

### Check MongoDB logs for errors

```shell
journalctl -u mongodb | grep ERROR
```

### Check MongoDB connectivity

```shell
mongo ${HOSTNAME}:${PORT}
```

### Check MongoDB database status

```shell
mongo ${HOSTNAME}:${PORT}/${DATABASE} --eval "db.stats()"
```

### Check MongoDB collection status

```shell
mongo ${HOSTNAME}:${PORT}/${DATABASE} --eval "db.${COLLECTION}.stats()"
```

### Check MongoDB process usage

```shell
top -p $(pgrep -d',' mongod)
```

### Check MongoDB disk usage

```shell
df -h ${MONGODB_DATA_DIRECTORY}
```


### Define the affected MongoDB instance

```shell
INSTANCE=${INSTANCE_NAME}
```

### Restart the MongoDB service

```shell
sudo systemctl restart mongodb.service
```

### Check the status of the MongoDB service

```shell
STATUS=$(sudo systemctl status mongodb.service | grep "Active:" | awk '{print $2}')
```

### Check if the service has started successfully

```shell
if [ "$STATUS" == "active" ]; then

    echo "MongoDB service has been restarted successfully."

else

    echo "Failed to restart MongoDB service."

fi
```


MongoDB instance down

Overview

Parameters

Debug

Check if MongoDB is running

Check MongoDB logs for errors

Check MongoDB connectivity

Check MongoDB database status

Check MongoDB collection status

Check MongoDB process usage

Check MongoDB disk usage

Repair

Define the affected MongoDB instance

Restart the MongoDB service

Check the status of the MongoDB service

Check if the service has started successfully

Learn more

Related Runbooks

Database Offline (SQLServer)

Redis replication broken incident.

Redis instance down incident

Redis disconnected slaves incident

Product

Resources

Support

Company