prometheus / prometheus/client_python
Provide APIs to help application developers test their Histogram-using code
Dieses Issue hat noch niemand übernommen.
- Vorherrschende Sprache
- Python
- Sterne
- 4.4k
- Forks
- 876
- Ø Merge
- 8 T. 4 Std.
- Gemergte PRs (30 T.)
- 1
Beschreibung
I have an application that uses Histogram. I want to write some tests that assert that my application is putting values into the right buckets of that histogram.
To read values out of the Histogram it seems that need to either:
- look at the Histogram's private
_bucketsattribute, or - call
Histogram.collectand look at the resultingMetricobjects which are documented as "intended only for internal use" and then look at itsSampleswhich aren't documented at all.
Neither of these seems particularly satisfactory. It would be very helpful if client_python provided some way to read bucket counts and the total sum from a Histogram, using documented APIs clearly marked as intended for external use (perhaps only in test suites).
Beitragsleitfaden
Erste Schritte
- Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
- Forke das Repository und arbeite in einem Branch.
- Öffne einen Pull Request, der die Issue-Nummer nennt.
Rechercherichtung
Beginne mit der Untersuchung der Histogram-Implementierung des Python-Clients, insbesondere seines _buckets-Attributs und seiner collect-Methode sowie der Metric- und Samples-Objekte, die sie zurückgibt. Definiere und teste eine dokumentierte externe API zum Auslesen der Bucket-Zählwerte und der Gesamtsumme, mit einer Abdeckung, die zeigt, dass Anwendungstests Werte überprüfen können, ohne private oder nur für interne Zwecke bestimmte Objekte zu verwenden.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- python
- Bereich
- observability
- Issue-Typ
- Feature
- Schwierigkeit
- 4/5
- Geschätzter Aufwand
- 3-5 Tage
- Aktivitätsstatus
- Veraltet
- Klarheit
- Größtenteils klar
- Anfängerfreundlichkeit
- 35/100