# 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.

{% stepper %}
{% step %}
**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.

{% code title="# prometheus.yml" %}

```yaml
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
```

{% endcode %}

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

{% step %}
**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:

{% code title="MariaDB Server host" %}

```bash
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
```

{% endcode %}

* For a MaxScale host:

{% code title="MaxScale host" %}

```bash
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
```

{% endcode %}

**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`).               |

{% hint style="success" %}
For a full list of all available flags and their descriptions, run `mema-agent help setup` on the host where the agent is installed.
{% endhint %}
{% endstep %}
{% endstepper %}

<sub>*This page is: Copyright © 2025 MariaDB. All rights reserved.*</sub>

{% @marketo/form formId="4316" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mariadb.com/docs/tools/mariadb-enterprise-manager/usage/monitoring/metrics/export-metrics.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.