Skip to content

Conversation

@jcord04
Copy link

@jcord04 jcord04 commented Dec 12, 2025

Add opt-in histogram metrics with configurable bucket boundaries to enable accurate percentile calculations (p50, p95, p99) for latency monitoring.

Changes:

  • Add PROMETHEUS_USE_HISTOGRAMS config option (default: False for backwards compatibility)
  • Add PROMETHEUS_LATENCY_BUCKETS config for customizable bucket boundaries
  • Convert timing values from milliseconds to seconds per Prometheus best practices
  • Update metrics implementation to support both Summary and Histogram modes
  • Add comprehensive test coverage for histogram functionality
  • Update documentation with migration guide and usage examples

Default buckets: [0.05, 0.1, 0.25, 0.5, 1.0, 2.5, 5.0, 10.0, 30.0, 60.0] seconds

Maintains full backwards compatibility - existing installations continue using Summary metrics unless explicitly opted-in to histograms.

Resolves: Feature request for configurable latency histogram buckets

Add opt-in histogram metrics with configurable bucket boundaries to enable
accurate percentile calculations (p50, p95, p99) for latency monitoring.

Changes:
- Add PROMETHEUS_USE_HISTOGRAMS config option (default: False for backwards compatibility)
- Add PROMETHEUS_LATENCY_BUCKETS config for customizable bucket boundaries
- Convert timing values from milliseconds to seconds per Prometheus best practices
- Update metrics implementation to support both Summary and Histogram modes
- Add comprehensive test coverage for histogram functionality
- Update documentation with migration guide and usage examples

Default buckets: [0.05, 0.1, 0.25, 0.5, 1.0, 2.5, 5.0, 10.0, 30.0, 60.0] seconds

Maintains full backwards compatibility - existing installations continue using
Summary metrics unless explicitly opted-in to histograms.

Resolves: Feature request for configurable latency histogram buckets
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants