Mesos App Exporter for Prometheus
Project description
🔥 mae
mae
collects Prometheus metrics from your Mesos apps.
See Deployment Strategy to learn how to set up mae
on your Mesos cluster.
Requirements
mae
requires Python (>= 2.7), and supports Python 3.
Installation
pip install mae
Usage
$ mae --help
usage: mae [-h] app_port slave_address slave_port
positional arguments:
app_port Port on which this exporter will run on
slave_address Mesos slave address
slave_port Mesos slave port
Task Labels
Once mae
is up and running, it will start collecting metrics from all apps that have the prometheus.metrics.enabled
label. You can also customize how the metrics are collected —
Task Label | Description | Required? | Default |
---|---|---|---|
prometheus.metrics.enabled |
Enables metrics collection. If the label isn't found, the app's metrics are not collected. | Yes | |
prometheus.metrics.port_index |
The port index where your app is exposing its Prometheus metrics. This is useful for Mesos apps that use multiple ports. | No | 0 |
prometheus.metrics.endpoint |
The endpoint where your app is exposing its metrics. | No | /metrics |
Deployment Strategy
mae
is designed to be run as a daemon on all Mesos slave nodes. This ideally involves 2 steps —
- Install
mae
as part of your base image/AMI or via user data. - Run
mae
as a daemon. For example, if your distro supportssystemd
, here's a sample script that runs the exporter on port8888
—# Save this to /etc/systemd/system/mae.service [Unit] Description=Mesos App Exporter After=network.target [Service] Type=simple Restart=on-failure ExecStart=/usr/local/bin/mae 8888 localhost 5051 # Assuming the Mesos slave process is running on port 5051 [Install] WantedBy=multi-user.target
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
mae-1.0.5.tar.gz
(5.2 kB
view hashes)
Built Distributions
mae-1.0.5-py2.7.egg
(9.1 kB
view hashes)
mae-1.0.5-py2-none-any.whl
(6.0 kB
view hashes)