Documentation forSolarWinds Observability

Add a MongoDB database instance

Monitor your MongoDB database instance with SolarWinds Observability on a dedicated host, or Atlas. Capture a robust assortment of MongoDB query metrics that give you insight into database performance and what consumes your database’s resources.

Get started

Before you start

See MongoDB system requirements to make sure your system is supported and you have the required roles, privileges, and prerequisites to monitor your MongoDB instance with SolarWinds Observability.

To monitor your MongoDB database instance with SolarWinds Observability, complete the following:

  1. In SolarWinds Observability, click Add Data at the top.

  2. On the Add Data dialog, click Database.

  3. Click MongoDB Self-hosted, or MongoDB Atlas from the MongoDB drop-down menu.

  4. Choose an existing SolarWinds Observability Agent on a monitored host. Click Next to continue.

    For more information about installing the SolarWinds Observability Agent on your host, see Add a self-managed host or Run the SolarWinds Observability Agent as a Docker image or Kubernetes deployment.

    If the Agent you want to use is not displayed in the wizard, make sure it has host monitoring enabled. See Enable host monitoring on an Agent.

  5. Enter the instance address, database username, and database password for the MongoDB instance. Click next to continue.

    Click the Enable SSL toggle and enter your SSL credentials to enable SSL. 

  6. Copy and execute the script on your MongoDB instance. The user account created with this script will be used by the SolarWinds Observability Agent.

    If you have an existing user account that you want to use, enter the credentials in the script box before clicking the copy to clipboard button.

  7. Choose the query capture method:

    • Choose On Host (recommended) if the service is in the same physical or virtual machine as the OS where you will install the SolarWinds Observability Agent.

      Npcap must be installed if you are monitoring databases for on-host data gathering on a Windows Installation. The On Host option is only available if you are monitoring a MongoDB Self-hosted instance.

    • Choose Log to monitor queries using the log. Copy and execute the provided command on your MongoDB instance.

    • Choose Profiler to monitor queries using the Profiler. Copy the script and add it to your MongoDB config file.

    Click I have performed all of the above tasks. Click Next to continue.

  8. Verify the information entered on the Summary tab. Click Finish.

    To view data collected for the newly configured entity in the Entity Explorer, click the name of the Database Instance in the confirmation dialog in the lower-left corner. It may take a few seconds for data to appear for the newly created entity. See Entity Explorer for details.

See Entities in SolarWinds Observability for an overview of Database Instance entities and how they work in SolarWinds Observability.