Skip to main content
Sumo Logic

Install the MongoDB Atlas App and view the Dashboards

This page provides instructions for installing the Sumo Logic App for MongoDB Atlas, as well as descriptions and examples for each of the dashboards.

This page provides instructions on how to install the MongoDB Atlas App, as well as examples of each of the dashboards. The App's pre-configured searches and Dashboards provide easy-to-access visual insights into your data. 

Install the App 

This section shows you how to install the Sumo Logic App for MongoDB Atlas. 

To install the app, do the following:

Locate and install the app you need from the App Catalog. If you want to see a preview of the dashboards included with the app before installing, click Preview Dashboards.

  1. From the App Catalog, search for and select the app. 
  2. To install the app, click Add to Library and complete the following fields.
    1. App Name. You can retain the existing name, or enter a name of your choice for the app.

    2. Data Source. Select either of these options for the data source.

      • Choose Source Category, and select a source category from the list.

      • Choose Enter a Custom Data Filter, and enter a custom source category beginning with an underscore. Example: (_sourceCategory=MyCategory).

    3. Advanced. Select the Location in Library (the default is the Personal folder in the library), or click New Folder to add a new folder.
  3. Click Add to Library.

Once an app is installed, it will appear in your Personal folder, or other folder that you specified. From here, you can share it with your organization. 

Panels will start to fill automatically. It's important to note that each panel slowly fills with data matching the time range query and received since the panel was created. Results won't immediately be available, but with a bit of time, you'll see full graphs and maps. 

Dashboard filters  

Each dashboard has a set of filters that you can apply to the entire dashboard, as shown in the following example. Click the funnel icon in the top dashboard menu bar to display a scrollable list of filters that are applied across the entire dashboard.

MongoDBAtlas_Dashboard_Filter.png

Each panel has a set of filters that are applied to the results for that panel only, as shown in the following example. Click the funnel icon in the top panel menu bar to display a list of panel-specific filters.

MongoDBAtlas_Panel_Filter.png

MongoDB Atlas - Overview Dashboard

The MongoDB Atlas - Overview dashboard provides an at-a-glance overview of server availability, messages, and commands. Panels display information on messages by severity and component, trends in messages by component and severity, as well as trends for database (DB) commands and create, read, update, and delete (CRUD) function commands.

Use this dashboard to:

  • Identify key operational metrics. You can drill down for granular data by clicking any of the first row panels. Monitor recent events and alerts. Click on the ID links to drill-down into the MongoDB Atlas console for more details.
  • Monitor unreachable nodes, running and stopped servers, and identify and fix host errors. 

 MongoDBAtlas_Overview.png

Security Dashboards

The MongoDB Atlas Security dashboards aim to provide a comprehensive view of Atlas security and audit aspects via the Atlas audit logs, alerts, and events logs.

MongoDB Atlas - Events Dashboard

The MongoDB Atlas - Events dashboard provides information on Atlas project and organization-level changes. Panels show information on the type, number, location and recent events.

Use this dashboard to:

  • Monitor most recent and past Atlas change events to ensure that the number and type of events are in line with expectations. 
  • Identify any violations in your security policies (such as users accessing Atlas without MFA).

MongoDBAtlas_Events.png

MongoDB Atlas - Alerts Dashboard

The MongoDB Atlas - Alerts dashboard provides an at-a-glance view view of alerts triggered in your Atlas environment. Panels show information around the total number and number of  open alerts, recent alerts, alert types and status.

Use this dashboard to:

  • Identify and address all open and recent alerts
  • Monitor unusually high number of  alerts by analyzing trend graphs

MongoDBAtlas_Alerts.png

MongoDB Atlas - Audit Dashboard

The MongoDB Atlas - Audit dashboard provides information around security events in your Atlas environment such as failed authentication, authorization and audit events, audit event trends, and originating geographic locations. Panels also display details on audit events by action type and user, and recent audit events by created and deleted resources.

Use this dashboard to:

  • Identify unusually high number of eventsfailed eventby analyzing trend graphs
  • Identify most affected hosts and users associated with failed audit events
  • Monitor most recent audit events and database operations to ensure they are in line with expectations
  • Track database read and write operations, spikes in failed events, as well as the users who performed the events

MongoDBAtlas_Audit.png

Performance Dashboards

Performance dashboards provide visual representations of key MongoDB Atlas metrics. You can use this data to correlate system health and performance and use Atlas logs to identify and fix the root cause of any problems. These dashboards are also provide the ability to fine tune your queries and database operations.

MongoDB Atlas - Cluster Metrics Dashboard

The MongoDB Atlas - Cluster Metrics dashboard provides a high-level view of cluster performance, disk and cache usage. Panel graphs show details for read and write operations and their execution times, network traffic, connections, data sizes, and disk read and write IOPs.

Use this dashboard to:

  • Identify anomalous changes in database metrics
  • Monitor resource usage and determine how to optimize your Atlas databases and clusters

MongoDBAtlas_Cluster_Metrics.png

MongoDB Atlas - Metrics Dashboard

The MongoDB Atlas - Metrics dashboard provides an at-a-glance view of database performance with graphs showing memory availability, data size, cache in bytes, and returned document ratios.

Use this dashboard to:

  • Determine node health based on page faults, cache dirty bytes, replication headroom, queued operations, and  disk write latency.
  • Monitor resource usage (cache and disk) and active connections. You can set up alerts for notification on these metrics.
  • Drill-down into the underlying queries and use the the Sumo Logic Log Overlay feature to correlate performance metrics with underlying logs to identify the root cause of performance degradations

MongoDBAtlas_Metrics.png 

MongoDB Atlas - Slow Queries Dashboard

The MongoDB Atlas - Slow Queries dashboard provides details on the number of slow queries by type,trends, and slow server status.

Use this dashboard to:

  • Identify and fix slow queries 
  • Identify changes in the number and types of slow queries by analyzing trends 
  • Identify databases, connections collections experiencing slow queries
  • Determine queries and operations that are using Scanned Objects/Returned objects and Keys Scanned Keys/Returned objects ratios to identify the potential fields for indexing

MongoDBAtlas_Slow_Queries.png

Operations Dashboards

The Operations dashboards monitor database operations, such as indexing, sharding, and replication. These dashboards allow you to view detailed error logs for troubleshooting and track login activities in your database including failed attempts.

MongoDB Atlas - Errors and Warnings Dashboard

The MongoDB Atlas - Errors and Warnings dashboard provides information on errors, warnings by component, severity and type.. Panels also show information on daily error and warning summaries, socket exceptions, timeout events, and MongoDB exit events.

Use this dashboard to:

  • Identify and fix errors and warnings 
  • Troubleshoot problems in your cluster by analyzing errors and warningsIdentify hosts with most errors and correct issues accordingly

MongoDBAtlas_Errors_and_Warnings.png

MongoDB Atlas - Logins and Connections Dashboard

The MongoDB Atlas - Logins and Connections dashboard provides a high-level view of the geographic locations of client connection requests, logins from malicious remote IPS, and geographic locations of failed logins. Panels also display information on overall failed login attempts, threat intel by remote IP, and failed logins by user.

Use this dashboard to:

  • Identify requests coming in malicious remote IPs and their geographic locations and use this information to fix your firewall or WAF devices
  • Validate locations of incoming client connections are in line with expected locations

MongoDBAtlas_Logins_and_Connections.png

MongoDB Atlas - Replication Dashboard

The MongoDB Atlas - Replication dashboard provides information on changes in replication configurations. Panels display details on replication errors, warnings, events, as well as information around primary and secondary nodes.

Use this dashboard to:

  • Identify and fix replication and availability errors
  • Monitor changes in replication lag performance

MongoDBAtlas_Replication.png

MongoDB Atlas - Sharding Dashboard

The MongoDB Atlas - Sharding dashboard provides information on Atlas cluster sharding. Panels show details on warnings, errors, chunk split failures, balancer failures, chunks moving by collection, and chunks moving between shards.

Use this dashboard to:

  • Identify and fix sharding and balancing related errors and warnings
  • Track chunk move operations to ensure they are in line with expectations

MongoDBAtlas_Sharding.png