Skip to content

docs: document Prometheus PushGateway usage#7604

Open
won-seoop wants to merge 1 commit into
micrometer-metrics:mainfrom
won-seoop:doc-4615-prometheus-pushgateway
Open

docs: document Prometheus PushGateway usage#7604
won-seoop wants to merge 1 commit into
micrometer-metrics:mainfrom
won-seoop:doc-4615-prometheus-pushgateway

Conversation

@won-seoop

Copy link
Copy Markdown

Summary

Closes #4615

The Prometheus documentation page had no mention of the Prometheus PushGateway despite being a frequently asked about use case (see also #3661). PushGateway is a Prometheus Java Client feature, not a Micrometer feature, but documenting it here greatly helps users discover the option.

Added a new == Prometheus PushGateway section to prometheus.adoc covering:

  • When to use it: short-lived batch jobs or apps that cannot expose a scrape endpoint
  • New client (micrometer-registry-prometheus): Maven/Gradle snippet + PushGateway.builder() code example using prometheusRegistry.getPrometheusRegistry()
  • Legacy client (micrometer-registry-prometheus-simpleclient): Maven/Gradle snippet + new PushGateway(host) code example
  • A NOTE pointing Spring Boot users to the PrometheusPushGatewayManager in Spring Boot Actuator

Test plan

  • Docs build with Antora renders the new section without errors
  • Maven/Gradle snippets are syntactically correct
  • Code examples follow existing style in the file

micrometer-metricsGH-4615: The Prometheus documentation did not mention the PushGateway at all.
Added a new "Prometheus PushGateway" section covering:
- Why/when to use the PushGateway (short-lived jobs, no scrape endpoint)
- New client (prometheus-metrics-exporter-pushgateway): Maven/Gradle + code example
- Legacy client (simpleclient_pushgateway): Maven/Gradle + code example
- Note pointing to Spring Boot Actuator for Spring Boot users

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
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.

Document usage of Prometheus PushGateway

1 participant