Architecture Overview

MariaDB Enterprise Manager is a client/server application for monitoring and managing MariaDB deployments. It provides topology-aware monitoring, visual schema management, and query editing across multiple database connections.

The architecture consists of two primary components: a central Enterprise Manager Server that aggregates data and hosts the user interface, and an Enterprise Manager Agent that is deployed on each monitored host.

Enterprise Manager Server

The Enterprise Manager Server runs on a dedicated host and acts as the central command center. It is delivered as a suite of Docker containers managed by Docker Compose.

The core components are the following:

Component	Description
Supermax	The primary backend application that serves the main web UI for management, server registration, and configuration.
Grafana	Provides powerful, pre-built dashboards for visualizing time-series performance metrics.
Prometheus	The time-series database that ingests and stores all monitoring data collected from the agents.
OpenTelemetry Collector	The central endpoint that receives telemetry data (metrics, logs, traces) from all agents.
Nginx	A web server that acts as a reverse proxy, directing browser traffic to the appropriate service (Supermax or Grafana).

Enterprise Manager Agent

The Enterprise Manager Agent is installed on each MariaDB Server and MaxScale host that you want to monitor. Its job is to collect data and forward it to the central server.

These components are installed via the mema-agent package (RPM or DEB) and include:

• Prometheus Exporters: These are the primary data gatherers.

  • Node Exporter: Collects system-level metrics (CPU, RAM, disk usage).

  • Mysqld Exporter: Collects detailed metrics from the MariaDB database itself.

• OpenTelemetry Collector: This local collector pulls data from the Prometheus exporters and pushes it to the central collector on the Enterprise Manager Server.

• mema-agent CLI: A setup utility used to register the host with the Enterprise Manager Server and configure the local agent services.

Networking Requirements

For the system to function correctly, the following firewall ports must be open on the Enterprise Manager Server host:

• 8090 (HTTP/S): The main entry point for the web UI. Nginx listens on this port and proxies requests to Supermax and Grafana.

• 4318 (HTTP/S): Agents on monitored nodes push telemetry data to this port.

_{This page is: Copyright © 2025 MariaDB. All rights reserved.}