From efea22e1f0e9b4f95f5595ce7ef7bf7bd7e9f92d Mon Sep 17 00:00:00 2001
From: Vidhya LKG for IT <24915474+VidhyaSanjeevi@users.noreply.github.com>
Date: Mon, 15 Dec 2025 10:39:54 +0530
Subject: [PATCH] Add dokploy-prom-monitoring-extension template with
 comprehensive tests and documentation (#548)

* Add dokploy-prom-monitoring-extension template with comprehensive tests and documentation

* Fix METRICS_CONFIG environment variable: use single-line JSON format

* Fix template.toml: use correct [config.env] syntax for environment variables

* Fix docker-compose.yml: add env_file reference to load environment variables

* Delete blueprints/dokploy-prom-monitoring-extension/README.md

* Delete test-dokploy-prom-monitoring-extension.sh

---------

Co-authored-by: Sanjeevi Subramani <ssanjeevi.ss@gmail.com>
Co-authored-by: Mauricio Siu <47042324+Siumauricio@users.noreply.github.com>
---
 .../docker-compose.yml                        | 11 ++++++++++
 .../logo.svg                                  | 21 +++++++++++++++++++
 .../template.toml                             | 17 +++++++++++++++
 meta.json                                     | 20 ++++++++++++++++++
 4 files changed, 69 insertions(+)
 create mode 100644 blueprints/dokploy-prom-monitoring-extension/docker-compose.yml
 create mode 100644 blueprints/dokploy-prom-monitoring-extension/logo.svg
 create mode 100644 blueprints/dokploy-prom-monitoring-extension/template.toml

diff --git a/blueprints/dokploy-prom-monitoring-extension/docker-compose.yml b/blueprints/dokploy-prom-monitoring-extension/docker-compose.yml
new file mode 100644
index 00000000..1fd3e03d
--- /dev/null
+++ b/blueprints/dokploy-prom-monitoring-extension/docker-compose.yml
@@ -0,0 +1,11 @@
+services:
+  dokploy-monitoring:
+    image: dokploy/monitoring:canary
+    restart: unless-stopped
+    env_file:
+      - .env
+    volumes:
+      - /var/run/docker.sock:/var/run/docker.sock:ro
+      - monitoring-data:/app/data
+volumes:
+  monitoring-data: {}
diff --git a/blueprints/dokploy-prom-monitoring-extension/logo.svg b/blueprints/dokploy-prom-monitoring-extension/logo.svg
new file mode 100644
index 00000000..5c6a02e4
--- /dev/null
+++ b/blueprints/dokploy-prom-monitoring-extension/logo.svg
@@ -0,0 +1,21 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 100 100" width="128" height="128">
+  <!-- Background circle -->
+  <circle cx="50" cy="50" r="48" fill="#E6522C" stroke="#CC4A1F" stroke-width="2"/>
+  
+  <!-- Prometheus flame icon adapted for monitoring -->
+  <path d="M50 15 L60 35 L80 35 L65 48 L72 68 L50 55 L28 68 L35 48 L20 35 L40 35 Z" 
+        fill="#FFF" opacity="0.95"/>
+  
+  <!-- Graph/Chart lines representing monitoring -->
+  <path d="M 20 75 L 30 65 L 40 70 L 50 60 L 60 65 L 70 55 L 80 60" 
+        stroke="#FFF" stroke-width="3" fill="none" stroke-linecap="round" opacity="0.8"/>
+  
+  <!-- Data points on the graph -->
+  <circle cx="20" cy="75" r="2.5" fill="#FFF"/>
+  <circle cx="30" cy="65" r="2.5" fill="#FFF"/>
+  <circle cx="40" cy="70" r="2.5" fill="#FFF"/>
+  <circle cx="50" cy="60" r="2.5" fill="#FFF"/>
+  <circle cx="60" cy="65" r="2.5" fill="#FFF"/>
+  <circle cx="70" cy="55" r="2.5" fill="#FFF"/>
+  <circle cx="80" cy="60" r="2.5" fill="#FFF"/>
+</svg>
diff --git a/blueprints/dokploy-prom-monitoring-extension/template.toml b/blueprints/dokploy-prom-monitoring-extension/template.toml
new file mode 100644
index 00000000..bd0c07b5
--- /dev/null
+++ b/blueprints/dokploy-prom-monitoring-extension/template.toml
@@ -0,0 +1,17 @@
+[variables]
+main_domain = "${domain}"
+monitoring_token = "${password:32}"
+callback_url = "http://dokploy:3000/api/trpc/notification.receiveNotification"
+server_type = "Dokploy"
+refresh_rate = "30"
+retention_days = "7"
+cpu_threshold = "80"
+memory_threshold = "85"
+
+[[config.domains]]
+serviceName = "dokploy-monitoring"
+port = 3001
+host = "${main_domain}"
+
+[config.env]
+METRICS_CONFIG = "{\"server\":{\"refreshRate\":${refresh_rate},\"port\":3001,\"type\":\"${server_type}\",\"token\":\"${monitoring_token}\",\"urlCallback\":\"${callback_url}\",\"retentionDays\":${retention_days},\"cronJob\":\"0 0 * * *\",\"thresholds\":{\"cpu\":${cpu_threshold},\"memory\":${memory_threshold}},\"prometheus\":{\"enabled\":true}},\"containers\":{\"refreshRate\":${refresh_rate},\"services\":{\"include\":[],\"exclude\":[]}}}"
diff --git a/meta.json b/meta.json
index 6dbc14d9..10956c5e 100644
--- a/meta.json
+++ b/meta.json
@@ -1830,6 +1830,26 @@
       "document-signing"
     ]
   },
+  {
+    "id": "dokploy-prom-monitoring-extension",
+    "name": "Dokploy Prometheus Monitoring Extension",
+    "version": "canary",
+    "description": "Dokploy monitoring extension with Prometheus metrics export for external monitoring systems like Grafana Cloud. Tracks server and container metrics with configurable thresholds and alerting.",
+    "logo": "logo.svg",
+    "links": {
+      "github": "https://github.com/Dokploy/dokploy",
+      "website": "https://dokploy.com/",
+      "docs": "https://docs.dokploy.com/"
+    },
+    "tags": [
+      "monitoring",
+      "prometheus",
+      "metrics",
+      "observability",
+      "docker",
+      "grafana"
+    ]
+  },
   {
     "id": "domain-locker",
     "name": "Domain Locker",