cefefc6897
Some checks are pending
buf.build / lint and publish (push) Waiting to run
CI / Go tests (push) Waiting to run
CI / More Go tests (push) Waiting to run
CI / Go tests with previous Go version (push) Waiting to run
CI / UI tests (push) Waiting to run
CI / Go tests on Windows (push) Waiting to run
CI / Mixins tests (push) Waiting to run
CI / Build Prometheus for common architectures (push) Waiting to run
CI / Build Prometheus for all architectures (push) Waiting to run
CI / Report status of build Prometheus for all architectures (push) Blocked by required conditions
CI / Check generated parser (push) Waiting to run
CI / golangci-lint (push) Waiting to run
CI / fuzzing (push) Waiting to run
CI / codeql (push) Waiting to run
CI / Publish main branch artifacts (push) Blocked by required conditions
CI / Publish release artefacts (push) Blocked by required conditions
CI / Publish UI on npm Registry (push) Blocked by required conditions
Scorecards supply-chain security / Scorecards analysis (push) Waiting to run
Relates to https://github.com/prometheus/prometheus/issues/16944#issuecomment-3164760343 Signed-off-by: bwplotka <bwplotka@gmail.com> |
||
|---|---|---|
| .. | ||
| io/prometheus | ||
| rwcommon | ||
| buf.gen.yaml | ||
| buf.lock | ||
| buf.yaml | ||
| codec.go | ||
| custom.go | ||
| README.md | ||
| remote.pb.go | ||
| remote.proto | ||
| types.pb.go | ||
| types.proto | ||
This directory contains Protocol Buffer (protobuf) definitions for Prometheus' remote read and write protocols. These definitions are used to serialize and deserialize time series data, such as metrics, labels, samples, and queries, for network communication to Prometheus.
The files here are synced to buf.build,
a public protobuf schema registry, from the main branch of the Prometheus
repository.
What This Package/Directory Hosts
Protobuf messages and services for:
- Remote Write: Sending time series data to Prometheus (e.g.,
WriteRequest,TimeSeries). - Remote Read: Querying data from Prometheus (e.g.,
ReadRequest,Query,ChunkedReadResponse). - Core types: Shared definitions like
Label,MetricMetadata, and exemplars.
Key files include:
remote.proto: Defines the remote read/write services and messages.types.proto: Common types used across protocols.io/prometheus/client/metrics.proto: Client metrics definitions.io/prometheus/write/v2/types.proto: Remote Write v2 protocol types.
Stability Guarantees
These protobuf definitions follow the stability policies of the Prometheus project. Backward-compatible changes may occur in minor releases, but breaking changes are reserved for major versions (e.g., Prometheus 3.0). Experimental or unstable features are clearly marked in the documentation.
Related Specifications
- Remote Write Spec v1: https://prometheus.io/docs/specs/remote_write_spec/.
- Remote Write Spec v2: https://prometheus.io/docs/specs/prw/remote_write_spec_2_0/.
- Experimental Prometheus client packages: https://github.com/prometheus/client_golang/tree/main/exp.
How to Change or Contribute
To modify these definitions, view and edit the source in the Prometheus GitHub repository: https://github.com/prometheus/prometheus/tree/main/prompb.
How to Use
Steps
- Run
make protoin the root directory to regenerate the compiled protobuf code. - The compiled Go code is version-controlled in the repository, so you typically don't need to re-generate unless making changes.