Documentation forSolarWinds Observability SaaS

Configure MongoDB database integration

The health state feature is not supported for MonoDB integrations. It will be supported in a future update.

To integrate MongoDB with SolarWinds Observability SaaS:

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

  2. In the Add Data dialog Intro, click the Integrations tab, and then click MongoDB.

  3. In the Add Mongo DB dialog, select a host with the SolarWinds Observability Agent you want to use for MongoDB and click Next.

    To display only Agents running in a Kubernetes cluster, click the List only Agents... toggle.

    If you want to install a dedicated Agent on a dedicated host, add the host and then add the MongoDB integration. See Add a self-managed host.

    If you prefer using Docker, see Run the SolarWinds Observability Agent as a Docker image or Kubernetes deployment.

  4. Select where the MongoDB service is located:

    • On Host: The MongoDB service runs on the same physical or virtual machine as the Agent.

    • Off Host: The MongoDB service runs on a different physical or virtual machine than the Agent.

  5. Provide the user name, copy the script, and run it on the MongoDB.

    Collecting MongoDB metrics requires that the account used to collect the data has access to appropriate tables. If the account cannot access the tables, relevant metrics will not be collected.

  6. Specify credentials to be used for authenticating the MongoDB integration in SolarWinds Observability SaaS.

    • Add New Credential

      Select this option to create new credentials. Provide a name for the credentials set and the requested details, such as credential name, username, and password.

    • Use Existing Credential

      Select this option to use existing credentials. Select credentials from the list.

  7. Review the configuration and click Deploy to deploy the changes to the agent.

    1. Select the Deployment Type.

    2. Provide a Display Name.

    3. Review the Mongo DB Endpoint.

    4. Review the Collection Interval.

    5. Provide a DBMS Instance Address.

  8. To secure the MongoDB connection using SSL, toggle the SSL Enabled option to On. Then specify the following options:

    Option Description
    sslEnabled

    Specify one of the following:

    • true: Enables SSL.

    • false: Disables SSL.
    Set SSL Mode

    Specify one of the following:

    • off: Disables SSL. No encryption or certificate verification is performed.

    • verify-full: Always use SSL. Verifies that the server certificate is issued by a trusted CA and that the server hostname matches the certificate.
    sslCA Specify the path to the root certificate file. This file must contain PEM-encoded data.
    sslKey Specify the path to the client certificate key file. This file must contain PEM-encoded data.

When the installation is complete, you can continue to observe MongoDB data. Use the buttons on the Summary screen.

To view metrics collected for MongoDB, click Analyze > Metrics and search for mongodb. See Metrics Explorer for details.