aboutsummaryrefslogtreecommitdiffstats
path: root/docker-compose/README.md
diff options
context:
space:
mode:
authorhalil.cakal <halil.cakal@est.tech>2024-11-26 16:33:46 +0000
committerhalil.cakal <halil.cakal@est.tech>2024-12-04 14:19:59 +0000
commit9d14873af2c4f0ca2221b1be3291c039a2e1ac6e (patch)
tree05696b69e252bc40cf555d0c3c31419e4444f664 /docker-compose/README.md
parent49c48df725d462a2085d37fc055df399c2dbd4fc (diff)
Add persistent storage to prometheus
- add healthcheck to ensure prometheus service is running correctly and restarts it if it becomes unhealthy - set the data retention time to 30d - update readme Issue-ID: CPS-2466 Change-Id: I0f6186f8577e8e0113831ed040298b823e33d624 Signed-off-by: halil.cakal <halil.cakal@est.tech>
Diffstat (limited to 'docker-compose/README.md')
-rw-r--r--docker-compose/README.md30
1 files changed, 29 insertions, 1 deletions
diff --git a/docker-compose/README.md b/docker-compose/README.md
index de1fbe296c..ea5a2a7610 100644
--- a/docker-compose/README.md
+++ b/docker-compose/README.md
@@ -1,7 +1,7 @@
<!--
============LICENSE_START=======================================================
Copyright (C) 2020 Pantheon.tech
- Modifications Copyright (C) 2020-2021 Nordix Foundation.
+ Modifications Copyright (C) 2020-2024 Nordix Foundation.
Modifications Copyright (C) 2021 Bell Canada.
Modifications Copyright (C) 2022 TechMahindra Ltd.
================================================================================
@@ -67,6 +67,34 @@ or
VERSION=<version> DB_USERNAME=cps DB_PASSWORD=cps docker-compose up -d
```
+## Running Docker containers with profile: monitoring
+
+Run docker-compose with profile, monitoring, then it will start monitoring services:
+* prometheus
+* grafana
+* kafka-ui
+
+```bash
+docker-compose --profile monitoring up -d
+```
+
+### prometheus service
+It collects and stores metrics as time series data, recording information with a timestamp.
+
+The environment variable, PROMETHEUS_RETENTION_TIME, is used to set the retention time for the metrics
+in the prometheus database. The default value is 15d, but can be changed to any value.
+
+To be able to use the historical data, the prometheus container should not be removed.
+Instead, it can be stopped and started using the following commands:
+
+```bash
+docker-compose start prometheus
+```
+
+```bash
+docker-compose stop prometheus
+```
+
## Running or debugging Java built code
Before running CPS, a Postgres database instance needs to be started. This can be done with following