up metric
A series Prometheus writes for every target after each scrape: 1 if the fetch worked and 0 if it failed.
In more detail
up is written by Prometheus itself, not by your service, so it still works when the service is dead. Alerting on up is usually the first alert a team writes, but up only proves the page could be fetched, not that the service's real work succeeds.
Example
curl -s 'localhost:9090/api/v1/query?query=up' returns checkout 1, otel-collector 1, prometheus 1.Related terms
- scrape — One fetch by Prometheus of a service's metrics page over HTTP, whose values are then stored with a timestamp.
- health endpoint — A web address, often /health, that a service answers quickly to show it is up.
- symptom-based alerting — Paging on what users feel, such as errors, slowness or unavailability, rather than on internal causes such as high CPU or a restarted process.
Taught in
- Prometheus Scraping And The Pull Model — Full-Stack Observability: Metrics, Tracing & Logging
- Forty Seconds At Two: Push, Pull And Service Discovery — Prometheus Certified Associate (PCA) Exam Prep