Export metrics

MariaDB Enterprise Manager provides two primary methods for exporting metrics, allowing you to integrate with external observability platforms for aggregation or long-term retention.

1

Scraping the built-in Prometheus endpoint (Server-to-Server)

The Prometheus server integrated within MariaDB Enterprise Manager exposes its metrics via a standard federation endpoint. You can configure your own external Prometheus server (or any Prometheus-compatible system) to "scrape" these metrics.

Identify the Federation Endpoint

The endpoint is located on your MariaDB Enterprise Manager server at the /prometheus/federate path. The full URL will be:

https://<Enterprise_Manager_IP>:8090/prometheus/federate

Configure Your External Prometheus

In your external Prometheus server's configuration file (prometheus.yml), add a new scrape job to target the Enterprise Manager endpoint.

# prometheus.yml

scrape_configs:
  - job_name: 'mem-federation'
    scrape_interval: 60s
    honor_labels: true
    metrics_path: '/prometheus/federate'
    params:
      'match[]':
        - '{job=~".+"}' # This parameter tells the endpoint to return all series.
    static_configs:
      - targets: ['<Enterprise_Manager_IP>:8090']
    scheme: https
    basic_auth:
      username: admin # default username for Enterprise Manager
      password: mariadb # default password for admin user
    # You may need to add TLS and authentication configurations
    # depending on your network setup and security requirements.
    # tls_config:
    #   insecure_skip_verify: true

After adding this configuration and restarting your external Prometheus, it will begin scraping and storing all metrics from your MariaDB Enterprise Manager instance.

2

Pushing metrics with the OpenTelemetry agent (Agent-to-External)

The mema-agent can be configured to push metrics directly to a third-party monitoring system that supports the OpenTelemetry Protocol (OTLP). This method sends data straight from the agent to your external endpoint, bypassing the built-in Prometheus server.

To configure this, run the mema-agent setup command on your MariaDB Server or MaxScale host with the appropriate flags.

Command examples

• For a MariaDB Server host:

MariaDB Server host

sudo mema-agent setup --cluster-name=MyCluster \
  --endpoint=https://<external_ip> --otlp-port=<external_port> \
  --mariadb --host-name=<hostname> \
  --mariadb-user=<user> --mariadb-password=<password> \
  --otlp-insecure --otlp-interval=60s

• For a MaxScale host:

MaxScale host

sudo mema-agent setup --cluster-name=MyCluster \
  --endpoint=https://<external_ip> --otlp-port=<external_port> \
  --maxscale --host-name=<hostname> \
  --maxscale-user=admin --maxscale-password=mariadb \
  --otlp-insecure --otlp-interval=60s

Flag descriptions

Flag	Description
--endpoint	The address of your external OTLP-compatible monitoring system.
--otlp-port	The port on the external system that accepts OTLP data.
--cluster-name	An informational name for the cluster this host belongs to.
--host-name	An informational name for this specific host.
--mariadb-user	The database user for scraping MariaDB Server metrics.
--mariadb-password	The password for the MariaDB user.
--maxscale-user	The MaxScale API user for scraping MaxScale metrics.
--maxscale-password	The password for the MaxScale user.
--otlp-insecure	Disables TLS certificate validation (use for testing or with self-signed certs).
--otlp-interval	The interval at which the agent should push metrics (e.g., 60s).

For a full list of all available flags and their descriptions, run mema-agent help setup on the host where the agent is installed.

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