#openmetrics #prometheus #metrics #instrumentation #monitoring

open-metrics-client

Open Metrics client library allowing users to natively instrument applications

16 releases (breaking)

0.13.0 Nov 21, 2021
0.12.0 Aug 7, 2021
0.11.2 Jun 9, 2021
0.8.0 Feb 27, 2021
0.4.0 Dec 31, 2020

#30 in Visualization

Download history 153/week @ 2021-08-10 343/week @ 2021-08-17 497/week @ 2021-08-24 450/week @ 2021-08-31 380/week @ 2021-09-07 670/week @ 2021-09-14 337/week @ 2021-09-21 344/week @ 2021-09-28 243/week @ 2021-10-05 829/week @ 2021-10-12 631/week @ 2021-10-19 749/week @ 2021-10-26 1590/week @ 2021-11-02 1702/week @ 2021-11-09 2433/week @ 2021-11-16 5750/week @ 2021-11-23

11,855 downloads per month
Used in 4 crates (2 directly)

Apache-2.0 OR MIT

82KB
1.5K SLoC

Open Metrics Client Library

Test Status Crate API

Rust client library implementation of the Open Metrics specification. Allows developers to instrument applications and thus enables operators to monitor said applications with monitoring systems like Prometheus.

Documentation: https://docs.rs/open-metrics-client/

Goals

  • No unsafe. Don't use unsafe Rust within the library itself.

  • Type safe. Leverage Rust's type system to catch common instrumentation mistakes at compile time.

  • Fast. Don't force users to worry about the performance impact of instrumentation. Instead encourage users to instrument often and extensively.

Specification Compliance

Below is a list of properties where this client library implementation lags behind the Open Metrics specification. Not being compliant with all requirements (MUST and MUST NOT) of the specification is considered a bug and likely to be fixed in the future. Contributions in all forms are most welcome.

  • State set metric.

  • Enforce "A Histogram MetricPoint MUST contain at least one bucket".

  • Enforce "A MetricFamily MUST have a [...] UNIT metadata".

  • Enforce "MetricFamily names [...] MUST be unique within a MetricSet."

  • Enforce "Names SHOULD be in snake_case".

  • Enforce "MetricFamily names beginning with underscores are RESERVED and MUST NOT be used unless specified by this standard".

  • Enforce "Exposers SHOULD avoid names that could be confused with the suffixes that text format sample metric names use".

  • Protobuf wire format. (Follow spec issue.)

  • Gauge histogram metric.

  • Allow "A MetricPoint in a Metric with the type [Counter, Histogram] SHOULD have a Timestamp value called Created".

  • Summary metric.

Related Libraries

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~0.4–0.8MB
~19K SLoC