Prometheus Metrics for Flask Web App
Project description
Flask Prometheus Metrics
Prometheus metrics exporter for Flask web applications.
flask_prometheus_metrics
uses official Prometheus Python Client
providing basic metrics about process resource usage, app's requests metrics and information.
Installation
pip install -U flask_prometheus_metrics
You will need Flask
to run examples below:
pip install -U 'flask_prometheus_metrics[flask]'
Usage
Run the following minimal example in Python shell:
from flask import Flask
from prometheus_client import make_wsgi_app
from werkzeug.middleware.dispatcher import DispatcherMiddleware
from werkzeug.serving import run_simple
from flask_prometheus_metrics import register_metrics
app = Flask(__name__)
@app.route("/")
def index():
return "Test"
# provide app's version and deploy environment/config name to set a gauge metric
register_metrics(app, app_version="v0.1.2", app_config="staging")
# Plug metrics WSGI app to your main app with dispatcher
dispatcher = DispatcherMiddleware(app.wsgi_app, {"/metrics": make_wsgi_app()})
run_simple(hostname="localhost", port=5000, application=dispatcher)
Then go over http://localhost:5000/
, refresh page a few times and check your
app's metrics at http://localhost:5000/metrics
.
See also example.py for more elaborate example of library usage in real Flask applications.
Metrics
flask_prometheus_metrics
exposes the following application metrics:
app_request_latency_seconds
(histogram) - Application request latencyapp_request_count_total
(counter) - application request countapp_version_info
(gauge) - application version
Library also provides some metrics about a Python interpreter used and process resource usage:
python_gc_objects_collected_total
(counter) - objects collected during gcpython_gc_objects_uncollectable_total
(counter) - uncollectable object found during GCpython_gc_collections_total
(counter) - number of times this generation was collectedpython_info
(gauge) - Python platform informationprocess_virtual_memory_bytes
(gauge) - virtual memory size in bytesprocess_resident_memory_bytes
(gauge) - resident memory size in bytesprocess_start_time_seconds
(gauge) - start time of the process since unix epoch in secondsprocess_cpu_seconds_total
(counter) - total user and system CPU time spent in secondsprocess_open_fds
(gauge) - number of open file descriptorsprocess_max_fds
(gauge) - maximum number of open file descriptors
Grafana dashboard
The metrics exported by flask_prometheus_metrics
can be scraped by
Prometheus monitoring system and then visualized in
Grafana.
You can download Grafana dashboard crafted specifically for the flask_prometheus_metrics
default metrics here.
Testing
When testing Flask application with DispatcherMiddleware
(see Usage example above)
you may want to use a little hack in order to make
Flask's test_client()
work properly.
History
v0.6.2 (2019-06-06)
- Codeclimate integration added
v0.6.1 (2019-06-06)
- Travis CI configuration fixed
v0.6.0 (2019-06-06)
- README and CHANGELOG as long description added
v0.5.0 (2019-06-06)
- CHANGELOG.md added
v0.4.0 (2019-06-06)
- Import simplified for metrics registration function
v0.3.1 (2019-06-05)
- Minor CI config fix
v0.3.0 (2019-06-05)
- Dependencies versions and safety checks added
v0.2.1 (2019-06-01)
- Update installation example in README
v0.2.0 (2019-06-01)
- README added, some code refactoring
v0.1.2 (2019-06-01)
- Version bumped
v0.1.1 (2019-06-01)
- Package versioning fix
v0.1.0 (2019-06-01)
- MVP
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
Built Distribution
Hashes for flask_prometheus_metrics-0.6.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 715c26a3d859f4aca919942db58aed8d7188dc18c000ff55be7b4f892b2156a8 |
|
MD5 | 94857ebb03a5f0c96dd2ba6e7cd83896 |
|
BLAKE2b-256 | b29f934925fb2c9aee5c06351a0ff17e7935a1e7aed5ec1ffaeaa68d2e6db9f8 |
Hashes for flask_prometheus_metrics-0.6.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 34a9a814566405e38cf1c8e08f99e343418eeb25b8ce7d2ef6e6eb09da47694c |
|
MD5 | fae51f981b034d75621a821411e88efe |
|
BLAKE2b-256 | 21354f7503f86ee4a2e89bf63f9fbea95039cd19c998c1f8d37bae0f8155c39f |