# line/promgen

Promgen is a configuration file generator for Prometheus

Repository: https://github.com/line/promgen
Canonical: https://ross.abutalabs.com/products/promgen
Homepage: https://line.github.io/promgen/
Language: Python
License: MIT
License Family: permissive
Topics: prometheus, monitoring, django
Last push: 2026-08-26T09:59:32+00:00

## Health v2 (maintenance only)
Score: 86/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 62, longevity 100
- inputs: {"age_days": 3684, "days_push": 7, "days_rel": 176, "gap_med": 33.5, "n_releases_24m": 13}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1132, forks 152 (observed 2026-08-28T04:03:42.665447+00:00)

## What it is
Promgen is a Django-based web application that generates and manages Prometheus configuration files, alert rules, and notification routing. It provides a management UI, API, and integrates with AlertManager for alert notifications.

## Use cases
- manage prometheus config files through a web ui
- generate prometheus scrape configs from service registry
- configure alert rules and notification routing for alertmanager
- self-hosted ui for managing prometheus targets and alerts
- route alertmanager notifications to different services

## When to choose
- you manage many prometheus targets and want a web UI instead of hand-editing YAML
- you need centralized alert rule and notification management across teams
- you want a self-hosted django app with plugin extensibility for discovery and notifications

## When to avoid
- you have a small single prometheus setup where plain config files suffice
- you prefer gitops-style config management rather than a database-backed UI
- you need a fully managed monitoring SaaS

## Facets
- artifact type: application
- maturity: active
- function: monitoring, alerting, configuration-management, web-framework
- domain: monitoring, self-hosted
- platform: self-hosted, python
- tags: prometheus, alertmanager, django, config-generator, devops, web-server, docker

## Member repositories
- line/promgen (main) score 86

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:42.665447+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:37:57.989196+00:00, confidence not recorded.
  - readme: https://github.com/line/promgen (fetched 2026-08-28T04:03:42.665447+00:00, sha f8e6bf2fe891)
  - homepage: https://line.github.io/promgen/ (fetched 2026-08-29T12:42:30.707234+00:00, sha e3825f27ffb2)
  - registry_pypi: https://pypi.org/pypi/promgen/json (fetched 2026-08-29T12:42:30.716654+00:00, sha f643165b9e02)
- Data as of 2026-08-30T08:39:29.467469+00:00.
