#open-metrics #metrics #prometheus-metrics #monitoring #instrumentation #prometheus

open-metrics-client

Open Metrics client library allowing users to natively instrument applications

17 releases (breaking)

0.14.0 Dec 29, 2021
0.13.0 Nov 21, 2021
0.12.1 Nov 9, 2021
0.11.2 Jun 9, 2021
0.4.0 Dec 31, 2020

#621 in Debugging

Download history 887/week @ 2023-12-08 1194/week @ 2023-12-15 426/week @ 2023-12-22 377/week @ 2023-12-29 395/week @ 2024-01-05 489/week @ 2024-01-12 348/week @ 2024-01-19 425/week @ 2024-01-26 246/week @ 2024-02-02 772/week @ 2024-02-09 774/week @ 2024-02-16 675/week @ 2024-02-23 512/week @ 2024-03-01 628/week @ 2024-03-08 456/week @ 2024-03-15 599/week @ 2024-03-22

2,298 downloads per month

Apache-2.0 OR MIT

80KB
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.

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

~1.5MB
~35K SLoC