ylighgh/prometheus-cloud-sd — explained in plain English
Analysis updated 2026-05-18
Automatically feed Prometheus a live list of cloud database and server targets to monitor.
Deploy the service on Kubernetes to track Redis, MySQL, PostgreSQL, and MongoDB across cloud accounts.
Filter which resources get monitored using scope and disable tags.
Use a stopped virtual server's disappearance from active targets as a monitoring signal.
| ylighgh/prometheus-cloud-sd | jesseduffield/openpray | jiangmuran/claude-in-box | |
|---|---|---|---|
| Stars | 24 | 24 | 24 |
| Language | Go | Go | Go |
| Setup difficulty | moderate | easy | moderate |
| Complexity | 4/5 | 2/5 | 4/5 |
| Audience | ops devops | general | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires cloud account credentials and a YAML config, runs best inside Kubernetes with provided manifests.
prometheus-cloud-sd is a tool that helps a monitoring system called Prometheus keep track of databases and servers running in the cloud, specifically on Alibaba Cloud and AWS. Prometheus is a popular tool for watching over software systems and alerting when something goes wrong, but it needs to be told what to watch. Cloud resources like databases get created and deleted often, so manually keeping that list updated is tedious. This project automatically finds those resources and hands Prometheus an up to date list to monitor. It currently discovers a specific set of resources: Redis and Tair caches, MySQL and PostgreSQL databases, MongoDB, and virtual servers, across both Alibaba Cloud's and AWS's equivalent services. It exposes this information through several web addresses that Prometheus can be pointed at, one for each resource type, plus health check addresses to confirm the service itself is running properly. Resources can be filtered in or out using tags, and even a stopped virtual server stays visible as an unreachable target on purpose, since that change in state can itself be a useful signal to monitor. The project is written in Go and is meant to run inside a Kubernetes cluster, with ready made deployment files provided, though it can also be run directly on a local machine for testing. Setting it up means providing cloud account credentials as environment variables or secrets, then writing a YAML configuration file that lists which cloud accounts, regions, and resource types to watch. The maintainers are upfront that some things are intentionally left out of this version, including a visual interface, a database for storing results, and login protection on its own endpoints. The architecture is built so that adding support for another cloud provider later would not require changing how Prometheus talks to the service. Planned future work includes support for Huawei Cloud, built in metrics, endpoint authentication, and an optional read-only interface. The project is licensed under the Apache License 2.0.
A Go service that automatically discovers cloud databases and servers on Alibaba Cloud and AWS so Prometheus can monitor them without manual setup.
Mainly Go. The stack also includes Go, Prometheus, Kubernetes.
Use freely for any purpose, including commercial use, as long as you keep the copyright notice and include a copy of the license.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly ops devops.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.