# prometheus/client_python

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/prometheus-client-python).**

4,333 stars · 859 forks · Python · Apache-2.0

## Links

- GitHub: https://github.com/prometheus/client_python
- awesome-repositories: https://awesome-repositories.com/repository/prometheus-client-python.md

## Topics

`instrumentation` `metrics` `prometheus` `python`

## Description

This is a Prometheus Python client library used for instrumenting Python applications. It provides the tools necessary to record counters, gauges, and histograms within a process to monitor application health and expose that data as a Prometheus exposition format provider.

The library enables cloud native observability by allowing developers to define custom telemetry and track internal application events. It transforms internal application data into a standardized text format required by Prometheus scrapers for collection.

The project covers a variety of monitoring and observability capabilities, including the use of label-based dimensional mapping for filtering and the implementation of pull-based metrics exposure via HTTP endpoints. It utilizes a thread-safe global registry and atomic counters to ensure consistent tracking across multiple application threads.

## Tags

### System Administration & Monitoring

- [Cloud Native Observability](https://awesome-repositories.com/f/system-administration-monitoring/cloud-native-observability.md) — Implements standardized observability signals for exporting system health and metrics in cloud-native environments.
- [Application Metric Tracking](https://awesome-repositories.com/f/system-administration-monitoring/application-metric-tracking.md) — Tracks internal application events using counters and histograms to monitor performance and health. ([source](https://github.com/prometheus/client_python/blob/master/pyproject.toml))
- [Application Performance Monitoring](https://awesome-repositories.com/f/system-administration-monitoring/application-performance-monitoring/application-performance-monitoring.md) — Enables monitoring of Python services in production by tracking runtime performance and internal events.
- [Dimensional Application Instrumentation](https://awesome-repositories.com/f/system-administration-monitoring/dimensional-application-instrumentation.md) — Records application metrics using dimensional tags to enable granular analysis of application health.
- [Pull-Based Metric Scraping](https://awesome-repositories.com/f/system-administration-monitoring/logging-and-telemetry/metric-data-ingestion/pull-based-metric-scraping.md) — Exposes collected telemetry via an HTTP endpoint for regular pull-based scraping by an external collector.
- [Prometheus-Formatted HTTP Endpoints](https://awesome-repositories.com/f/system-administration-monitoring/metrics-exporters/prometheus-formatted-http-endpoints.md) — Formats internal application data into a Prometheus-formatted HTTP endpoint for external scraping.
- [Prometheus Client Libraries](https://awesome-repositories.com/f/system-administration-monitoring/prometheus-client-libraries.md) — Provides a comprehensive Python library for instrumenting applications and exposing metrics to Prometheus.
- [Prometheus Metrics Exporters](https://awesome-repositories.com/f/system-administration-monitoring/prometheus-exporters/prometheus-based-metric-exporters/prometheus-metrics-exporters.md) — Provides instrumentation tools to expose application metrics in the standard Prometheus format.
- [Custom Telemetry Definitions](https://awesome-repositories.com/f/system-administration-monitoring/service-metrics-monitoring/custom-metric-blueprints/custom-telemetry-definitions.md) — Allows defining custom telemetry for tracking business-specific events and technical internal state.
- [Metric Registries](https://awesome-repositories.com/f/system-administration-monitoring/monitoring-and-observability/observability-platforms/metric-performance-monitors/virtual-thread-monitors/thread-safe-metric-counters/metric-registries.md) — Provides a thread-safe global registry to centrally store and manage all instrumented metrics.

### Data & Databases

- [Label-Based Multi-Dimensionality](https://awesome-repositories.com/f/data-databases/multi-dimensional-analysis/label-based-multi-dimensionality.md) — Supports multi-dimensional time series by organizing metrics using label-value pairs for flexible filtering.
- [Gauge Trackers](https://awesome-repositories.com/f/data-databases/event-tracking/metric-rate-tracking/time-series-value-trackers/gauge-trackers.md) — Provides gauges to record single numerical values that represent the current state of a monitored resource.

### Development Tools & Productivity

- [Atomic Counters](https://awesome-repositories.com/f/development-tools-productivity/change-tracking/state-tracking-utilities/sequential-counters/atomic-counters.md) — Implements thread-safe atomic counters to prevent data loss during concurrent numeric updates.