{"repo":"home-operations/kromgo","free":true,"listed":false,"github":"https://github.com/home-operations/kromgo","clone":"git clone https://github.com/home-operations/kromgo.git","description":"Build badges and graphs from PromQL and share them in your READMEs","language":"Go","stars":154,"topics":["prometheus","badges-markdown","victoria-metrics","graphs-markdown","0ver","kubernetes"],"license":"AGPL-3.0","category":"deployment-docker-iac","readme_excerpt":"Kromgo Safely expose individual Prometheus metric values to the public web. Define named endpoints backed by PromQL queries and serve them as SVG badges, themed SVG/PNG graphs, or JSON — without exposing your Prometheus instance directly. Badges render as shields.io-style SVG, so you can embed /badges/{id} straight into an tag — no shields.io round-trip required (though it's still supported via ?format=shields ). How it works kromgo sits between the public web and your Prometheus. You define two kinds of endpoint: - Badges ( /badges/{id} ) render an instant value as an SVG badge, shields.io JSON, or kromgo JSON. - Graphs ( /graphs/{id} ) render a time series as a themed SVG/PNG chart or JSON. Each maps a URL path to a PromQL query. Only the endpoints you define are reachable — Prometheus itself is never exposed. The root path / serves a gallery that previews every endpoint next to its copy-paste Markdown snippet — handy for grabbing a badge for a README. Quick start Then embed or query a badge: Docker Compose Kubernetes (Helm) kromgo publishes an OCI Helm chart to oci://ghcr.io/home-operations/charts/kromgo : The config value is rendered verbatim into a ConfigMap mounted at /config/config.yaml , so the config schema below maps directly onto it. Notable values (see charts/kromgo/values.yaml ): Value Purpose ------------------------------------------ ----------------------------------------------------------------------------- config.prometheus Prometheus URL kromgo queries con","default_branch":null,"files":null,"tree":[],"storefront":"/r/home-operations","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/home-operations/kromgo/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}