Connection Details

SectionFieldDescription
Create New CollectorDatabase TypeThe database type that you want to monitor.
AgentThe Database Agent that manages the collector.
Collector NameThe name you want to identify the collector by.
Connection DetailsHostname or IP AddressThe hostname or IP address of the machine that your database is running on.
Listener PortThe TCP/IP address of the port on which your database communicates with the Database Agent.
Custom Connection String

The connection string generated by the database agent. You can also specify a custom connection string, which is useful for setting custom authentication options.

Note: Ensure that you do not specify the username and password in the custom connection string because it can cause a security risk.
SRV RecordEnable this field to use the SRV record, where the connection string includes mongodb+srv .
Database Credentials UsernameThe name of the user who is connecting to and monitoring the database through the Database Agent. The user should have the permissions described in User Permissions for MongoDB.
PasswordThe password of the user who is connecting to and monitoring the database through the Database Agent.
CyberArkClick to enable CyberArk for database username and password. When CyberArk is enabled, information about Application, Safe, Folder, and Object is required to fetch the username and password for your database. To use CyberArk with Database Visibility, you must download the JavaPasswordSDK.jar file from the CyberArk web site and rename the file to cyberark-sdk-9.5.jar. Then, you must copy the JAR file to the lib directory of the database agent zip file.
HashiCorp VaultSee Configure the HashiCorp Vault.
Advanced OptionsSSL Connection

Click to enable SSL Connection:

  • Truststore Location: Location of the certificate on the DB Agent host.
  • Truststore Type: Type of SSL Connection. There are three truststore types:
    • PKCS12 (default)
    • JKS
    • SSO: Enables auto-login. If you use SSO, you only need to provide the truststore location and truststore type
  • Truststore Password: Password for SSL Connection.

If you also use client certificate authentication, then click the Enable SSL Client Authentication box.

  • Keystore Location: location of the certificate on the DB Agent host.
  • Keystore Type: type of SSL Connection.
  • Keystore Password: password for SSL Connection.

You can set the context protocol for the SSL environment by using the following system variable:

dbagent.mongodb.ssl.context.protocol

If you do not set the context protocol through the system variable, TLSv1.3 is used by default.

These platforms support TLSv1.3:

  • Oracle JDK >= 8u261-b12
  • AdoptOpenJDK >= 8u262-b10
  • Azul Platform Prime >= 20.07.0.0
Note: If a JDK version does not support TLSv1.3 or the specified context protocol, Splunk AppDynamics switches to TLSv1.2.
Exclude DatabasesThe databases that you want to exclude, separated by commas.
Monitor Operating SystemSee Configure the Database Agent to Monitor Server Hardware.
Note: When configuring the collector, ensure that you encode the username and password that uses special characters.