Outdated Version

You are viewing an older version of this section. View current production version.

Configure SingleStore DB Monitoring min read


You may continue to use the historical monitoring, SingleStore’s former monitoring solution, if you are currently unable to migrate to SingleStore’s native monitoring solution.

Please note that historical monitoring has been deprecated in favor of SingleStore’s native monitoring solution and may no longer function in future versions of SingleStore DB.

SingleStore’s native monitoring solution is designed to capture and reveal cluster events over time. By analyzing this event data, you can identify trends and, if necessary, take action to remediate issues.

If you are currently using historical monitoring, SingleStore’s former monitoring solution, and have upgraded to SingleStore DB 7.1.8 or later, you may continue to use the former monitoring solution without taking any additional action. You may use this guide if you prefer to migrate to this new monitoring solution.


Throughout this guide, the cluster that is being monitored will be referred to as the “Source” cluster, and the cluster that stores the monitoring data will be referred to as the “Metrics” cluster. The databases that store monitoring data will be referred to as the metrics database.

SingleStore Native Monitoring Solution High-Level Architecture


In SingleStore’s native monitoring solution, the Metrics cluster utilizes a SingleStore pipeline to pull the data from the exporter process on the Source cluster and stores it in a database named metrics. Note that this metrics database can either reside within the same cluster as the Source cluster, or within a dedicated cluster.

When these event data is then analyzed through the associated Grafana dashboards, trends can be identified and, if necessary, actions taken to remediate issues.

The provided Grafana dashboards include:

Dashboard Description
Active session history Aggregated resource consumption by activity and activity type
Activity history Resource consumption by a specific activity over time
Detailed cluster view A “birds-eye view” of a single cluster
Information schema view Provides a view into information_schema views PROCESSLIST, TABLES, and TABLE_STATISTICS
Memory usage Granular breakdown of memory use for a host
SingleStore DB status and variables view Collected status variables from each host in the cluster
Node breakout System metrics from each host in the cluster
Node drilldown System metrics from each host in the cluster, with the ability to focus on a specific metric subsystem



These instructions have been developed for clusters that have been installed and deployed via .rpm or .deb packages as a sudo user.

If your cluster was deployed via tarball as a non-sudo user, change to the directory (cd) in which singlestoredb-toolbox was untarred, and run all sdb-admin commands as ./sdb-admin.

Note that the Grafana instructions will require a user with sudo access to install and configure the associated Grafana components.

  • A SingleStore DB 7.1.8 or later cluster to monitor (the Source cluster).
  • Optional: A separate SingleStore DB 7.1.8 or later cluster to collect monitoring data (the Metrics cluster).
    • This can be the same as, or separate from, the Source cluster.
    • If you opt to use a separate cluster, we recommend a cluster with two aggregator nodes and two leaf nodes, each with 2TB disks and with high availability (HA) enabled.
  • Clusters are managed with SingleStore DB Toolbox 1.7.0 or later.
  • A Grafana 6.0.0 or later instance that can access the Metrics cluster.
  • SingleStore DB Toolbox is recommended for managing the clusters as automation during setup is provided through sdb-admin commands. While monitoring can be enabled through a series of SQL commands, the preferred method is to use SingleStore DB Toolbox.

Port Configuration

Default Port Used by Invoked by
3000 Grafana User browser
3306 SingleStore DB memsql_exporter
8080 SingleStore DB Studio User browser
9104 memsql_exporter SingleStore pipelines