--- title: "How to monitor MongoDB performance with Datadog" description: "Learn how to use the Datadog platform for comprehensive MongoDB monitoring." author: "Jean-Mathieu Saponaro" date: 2016-05-25 tags: ["infrastructure monitoring", "database monitoring", "mongodb"] blog_type_id: the-monitor locale: en --- *This post is the last of a 3-part series about monitoring MongoDB. Part 1 presents the key performance metrics available from MongoDB: there is *[*one post for the WiredTiger*](https://www.datadoghq.com/blog/monitoring-mongodb-performance-metrics-wiredtiger.md)* storage engine and *[*one for MMAPv1*](https://www.datadoghq.com/blog/monitoring-mongodb-performance-metrics-mmap.md)*. *[*Part 2*](https://www.datadoghq.com/blog/collecting-mongodb-metrics-and-statistics.md)* explains the different ways to collect MongoDB metrics.* If you’ve already read our first two parts in this series, you know that monitoring MongoDB gives you a range of metrics that allow you to explore its health and performance in great depth. But for databases running in production, you need a robust monitoring system that collects, aggregates, and visualizes MongoDB metrics along with metrics from the other parts of your infrastructure. Advanced alert mechanisms are also essential to be able to quickly react when things go awry. In this post, we’ll show you how to start monitoring MongoDB in a few minutes with Datadog. ![Monitor MongoDB graphs on Datadog](https://web-assets.dd-static.net/42588/1776357474-monitor-mongodb-performance-with-datadog-mongodb-performance-metrics.png) ## Monitor MongoDB performance in 3 easy steps ### Step 1: install the Datadog Agent The Datadog Agent is [the open-source software](https://github.com/DataDog/dd-agent) that collects and reports metrics from your hosts so that you can visualize and monitor them in Datadog. Installing the [agent](https://www.datadoghq.com/blog/dont-fear-the-agent.md)usually takes just a single command. Installation instructions for a variety of platforms are available [here](https://app.datadoghq.com/account/settings/agent/latest?platform=overview). MongoDB also requires a user with “[read](https://docs.mongodb.com/manual/reference/built-in-roles/#read)” and “[clusterMonitor](https://docs.mongodb.com/manual/reference/built-in-roles/#clusterMonitor)” client [roles](https://docs.mongodb.com/manual/reference/built-in-roles/#database-user-roles) for Datadog so the Agent can collect all the server statistics. The commands to run in the mongo shell differs between MongoDB versions 2.x and 3.x. They are detailed in the “configuration” tab of the [MongoDB’s integration tile on the integrations page on Datadog](https://app.datadoghq.com/account/settings#integrations/mongodb). ![Monitor MongoDB graphs on Datadog](https://web-assets.dd-static.net/42588/1776357478-monitor-mongodb-performance-with-datadog-mongodb-integration.png) As soon as your Agent is up and running, you should see your host reporting metrics [on your Datadog account](https://app.datadoghq.com/infrastructure). ![Monitor MongoDB Datadog Agent reporting metrics](https://web-assets.dd-static.net/42588/1776357482-monitor-mongodb-performance-with-datadog-mongodb-agent-setup.png) ### Step 2: configure the Agent Then you’ll need to create a simple MongoDB configuration file for the Agent. For Linux hosts, configuration files are typically located **in/etc/dd-agent/conf.d/**, but you can find OS-specific config information [here](https://docs.datadoghq.com/agent.md). The Agent configuration file **mongo.yaml** is where you provide instances informations. You can also apply tags to your MongoDB instances so you can filter and aggregate your metrics later. The Agent ships with a **mongo.yaml.example** template, but to access all of the metrics described in [Part 1](https://www.datadoghq.com/blog/monitoring-mongodb-performance-metrics-wiredtiger.md) of this series, you should use the modified YAML template available [here](https://github.com/DataDog/integrations-core/blob/master/mongo/datadog_checks/mongo/data/conf.yaml.example). ### Step 3: verify the configuration settings Restart the Agent using the [right command](https://docs.datadoghq.com/agent.md) for your platform, then check that Datadog and MongoDB are properly integrated by running the Datadog **info** command. If the configuration is correct, you should see a section like this in the info output: ```text Checks ====== [...] mongo ----- - instance #0 [OK] - Collected 8 metrics & 0 events ``` ### That’s it! You can now turn on the integration You can now switch on the MongoDB integration inside your Datadog account. It’s as simple as clicking the “Install Integration” button under the Configuration tab in the [MongoDB integration tile](https://app.datadoghq.com/account/settings#integrations/mongodb) on your Datadog account. ## Metrics! Metrics everywhere! Now that the Agent is properly configured, you will see all the MongoDB metrics available for monitoring, graphing, and correlation on Datadog. You can immediately see your metrics populating a default dashboard for MongoDB containing the essential MongoDB metrics presented in [Part 1](https://www.datadoghq.com/blog/monitoring-mongodb-performance-metrics-wiredtiger.md). It should be a great starting point for your monitoring. You can clone this dashboard and customize it as you wish, even adding metrics from other parts of your infrastructure so that you can easily correlate what’s happening in MongoDB with what’s happening throughout your stack. ![Monitor MongoDB Dashboard on Datadog](https://web-assets.dd-static.net/42588/1776357486-monitor-mongodb-performance-with-datadog-datadog-mongodb-dashboard.png) *MongoDB default dashboard on Datadog* ## Alerting Once Datadog is capturing and graphing your metrics, you will likely want to set up some [alerts](https://www.datadoghq.com/blog/monitoring-101-alerting.md) to keep watch over your metrics and to notify your teams about any issues. Datadog allows you to alert on individual hosts, services, processes, and metrics—or virtually any combination thereof. For instance, you can monitor all of your hosts in a certain availability zone, or you can monitor a single key metric being reported by each of your MongoDB hosts. For example, as explained in [Part 1](https://www.datadoghq.com/blog/monitoring-mongodb-performance-metrics-wiredtiger.md), the number of current connections is limited to 65,536 simultaneous connections by default since v3.0. So you might want to set up an alert whenever the corresponding metric is getting close to this maximum. ![Monitor MongoDB Datadog alert](https://web-assets.dd-static.net/42588/1776357491-monitor-mongodb-performance-with-datadog-mongodb-datadog-alert.png) Datadog also integrates with many communication tools such as Slack, PagerDuty or HipChat so you can notify your teams via the channels you already use. ## You are now a MongoDB pro! This concludes the series on how to monitor MongoDB. In this post we’ve walked you through integrating MongoDB with Datadog to visualize your key metrics and notify your team whenever your database shows signs of trouble. If you’ve followed along using your own Datadog account, you should now have unparalleled visibility into MongoDB’s activity and performance. You are also aware of the ability to create automated alerts tailored to your environment, usage patterns, and the metrics that are most valuable to your teams. If you don’t yet have a Datadog account, you can sign up for and start monitoring MongoDB alongside the rest of your infrastructure, your applications, and your services today.