Skip to main content
Get more insights into the operation of your MongoDB database or cluster with our Vector MongoDB integration. Vector has a MongoDB source that collects metrics from your MongoDB instances. When these MongoDB metrics are sent to AppSignal, they create the MongoDB Intelligence dashboards.

​
Configuration

If you’ve not set up Vector yet, please see the Vector configuration section for more information, such as which Push API key to use.
To send MongoDB data to AppSignal using Vector, you will need to configure the MongoDB source and AppSignal sink in your Vector configuration. We’ll be using the TOML configuration file as an example.
  1. Add a new source of the mongodb_metrics source type to your configuration file. The name of the source is the part following the dot in sources.mongodb, not the mongodb_metrics type.
  1. Configure the source’s endpoints option with the MongoDB URL for your database. Replace the variables ($VARIABLE_NAME) with the values for your database, or pass them as environment variables. If running a database cluster, you should specify each member of the cluster as an endpoint.
  1. Update inputs in the appsignal sink to include the name of the mongodb_metrics source:
Shown below is an example vector.toml configuration file. Your Vector configuration method may be different.

​
Dashboards

From your MongoDB instances’ metrics, AppSignal creates up to three Intelligence dashboards, grouped under MongoDB in the sidebar. Each graph has at least one line per endpoint and host. Some graphs split these further by state or type.

​
Status dashboard

The Status dashboard focuses on the overall health and activity of your MongoDB instances. Status dashboard It will report graphs for resident memory usage, network usage, document operations, network connections, transactions, and open sessions. This dashboard allows you to quickly spot what’s impacting your database or your application, such as a drop in database connections or an increase in memory usage.

​
WiredTiger dashboard

The WiredTiger dashboard provides an in-depth view into the internals of the MongoDB database engine. WiredTiger dashboard It will report graphs for journal operations as a count and in bytes, block manager bytes read and written, cache size, available concurrent transaction tickets, and open cursors. If you’re dealing with a hard-to-track issue, such as an unexpected drop in database performance, these graphs can provide clues as to what the underlying cause is.

​
Replication dashboard

The Replication dashboard provides a view into the internals of the MongoDB cluster replication system. This dashboard will only appear if you are running a MongoDB cluster. Replication dashboard It will report graphs for the amount of network usage dedicated to replication, the size of the replication buffers, the amount of replication operations pending execution, and the time spent applying replication batches. This dashboard can help investigate issues related to the health of your cluster, such as stale reads and replication delays.