[In Development] Monitoring Percona TokuMX

Configure the Server Density agent to monitor your TokuMX server to:

• Collect important metrics, such as performance, connections and slow queries
• Identify overall server slowdowns caused by the database server

Note: This plugin is still in development and is not yet available to install. We will add new plugins to our release notes.

Configuring the agent to monitor TokuMX

1. Connect to the mongo shell and create a monitoring user:

use admin
db.createUser({user: “serverdensity”, pwd: “supersecretpassword”, roles: [ “read”,”clusterAdmin”,”readAnyDatabase” ]})

2. Configure /etc/sd-agent/conf.d/tokumx.yaml

  - server: mongodb://serverdensity:supersecretpassword@localhost:27016/admin 
  • If you run the database server on a non-standard port, you need to declare the path to the sock or want to execute check, amend the rest of the config file as necessary. 

3. Restart the agent

sudo /etc/init.d/sd-agent restart

Verifying the configuration
Execute info to verify the configuration with the following:

sudo /etc/init.d/sd-agent info 

If the agent has been configured correctly you’ll see an output such as:

  - instance #0 [OK]
  - Collected 32 metrics, 0 events & 1 service check

Connecting over SSL

We can connect to your TokuMX instances using SSL but it may require some changes to the agent if you are using certificate files.

  • If you are not using certificate files

 You can just specify ?ssl=true in the connection string e.g. in step 2 of the installation instructions, then specify mongodb://hostname:port/?ssl=true as part of the config.

  • If you are using certificate files

If you are using cert files then you'll need to tell the agent where they are. Set these 4 lines in your {agentdir}/conf.d/tokumx.yaml file:

ssl: True # Optional (default to False)
ssl_keyfile: /path/to/key.file
ssl_certfile: /path/to/cert.file

Configuring graphs

Click the name of your server from the Devices list in your Server Density account then go to the Metrics tab. Click the + Graph button on the right then choose the TokuMX metrics to display the graphs. The metrics will also be available to select when building dashboard graphs.

Further Reading

We have a detailed blog post on how to monitor MongoDB.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request


Monday  —  Friday.

10am  —  6pm UK.

Dedicated Support.