About Saagie Usage Monitoring
It is available in the official Saagie repository and you can install it in any project. However, since the app is designed to display cross-project metrics, Saagie recommends deploying it in a dedicated administration project.
Its installation requires some configuration to work. Your user account must have view rights on at least all projects, and you must set several environment variables. For more information, see the README help file. |
Architecture and Operating Mode
SUM is based on the combination of several components, including a Grafana app, a Python job, a Cron, a TTYD or a pgAdmin, and either an internal or external PostgreSQL.


-
The Python job retrieves data from jobs and pipelines through the Saagie API, and imports it into a PostgreSQL database initiated when SUM starts.
Data can also be imported from S3 or HDFS storage, which must be configured with environment variables when installing SUM. For more information, see the README help file. -
The Cron runs the Python job every hour to synchronize the data.
-
The PostgreSQL database feeds your alerts and dashboards by transmitting the retrieved data to the Grafana.
-
TTYD and pgAdmin allow you to write your queries.
You can also use the pgAdmin app to look into the PostgreSQL and analyze the data model.
External PostgreSQL Database
To use an external PostgreSQL database, you must define the connection parameters via the corresponding environment variables in Saagie:
-
SAAGIE_PG_HOST
: PostgreSQL host
→ The default value islocalhost
. -
SAAGIE_PG_PORT
: PostgreSQL port
→ The default value is5432
. -
SAAGIE_PG_USER
: PostgreSQL user
→ The default value issupervision_pg_user
. -
SAAGIE_PG_PASSWORD
: PostgreSQL password
→ The default value is ` `. -
SAAGIE_PG_DATABASE
: PostgreSQL database
→ The default value issupervision_pg_db
.