prometheus/client_python
Client Python
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.
Features
- Cloud Native Observability - Implements standardized observability signals for exporting system health and metrics in cloud-native environments.
- Label-Based Multi-Dimensionality - Supports multi-dimensional time series by organizing metrics using label-value pairs for flexible filtering.
- Application Metric Tracking - Tracks internal application events using counters and histograms to monitor performance and health.
- Application Performance Monitoring - Enables monitoring of Python services in production by tracking runtime performance and internal events.
- Dimensional Application Instrumentation - Records application metrics using dimensional tags to enable granular analysis of application health.
- Pull-Based Metric Scraping - Exposes collected telemetry via an HTTP endpoint for regular pull-based scraping by an external collector.
- Prometheus-Formatted HTTP Endpoints - Formats internal application data into a Prometheus-formatted HTTP endpoint for external scraping.
- Prometheus Client Libraries - Provides a comprehensive Python library for instrumenting applications and exposing metrics to Prometheus.
- Prometheus Metrics Exporters - Provides instrumentation tools to expose application metrics in the standard Prometheus format.
- Custom Telemetry Definitions - Allows defining custom telemetry for tracking business-specific events and technical internal state.
- Gauge Trackers - Provides gauges to record single numerical values that represent the current state of a monitored resource.
- Atomic Counters - Implements thread-safe atomic counters to prevent data loss during concurrent numeric updates.
- Metric Registries - Provides a thread-safe global registry to centrally store and manage all instrumented metrics.
