-
Notifications
You must be signed in to change notification settings - Fork 82
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
src/registry: Use dynamic dispatch and remove type parameter M #100
Conversation
Instead of being generic over the metric type on `Registry`, use dynamic dispatch. On the upside this significantly simplifies type signatures exposed to the user. On the downside this requires users to always use dynamic dispatch and requires all metrics to implement auxiliary trait `Debug` and auto traits `Send` and `Sync`.
Personally, I box all my metrics anyway, because I need to use many different types with one registry. So I'm okay with that tradeoff. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for exploring this!
The problem domain we have here is basically the same as serde
's, thus I think the ideal solution might be a visitor pattern with an abstract data model.
That would make the actual Encode
trait oblivious about the underlying format, same as serde
's Serialize
. A registry could then pick a particular Encoder
implementation and encode all metrics via double-dispatch.
This being said, serde
's design is obviously designed around having a plethora of actual serialization formats whereas here we only have two (I think?) so it might not worth it.
Thoughts?
&mut self, | ||
name: N, | ||
help: H, | ||
metric: impl Metric, |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Would it make sense to take a reference here? I think the caller will always have to clone it, otherwise they are not gonna have a reference to it to actually use the metric, meaning we can do the cloning for them, therefore slightly simplifying the API.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
My intention taking an owned value instead of a reference was to be explicit about the otherwise internal clone.
I think the caller will always have to clone it, otherwise they are not gonna have a reference to it to actually use the metric
Not in the case of a constant metric, i.e. a metric that never changes. For such a metric the user does not need a handle to it, and can thus pass the only instance to register
.
I would stick with the owned signature, though I don't feel strongly about it.
/// let subsystem_a_counter_1: Counter = Counter::default(); | ||
/// let subsystem_a_counter_2: Counter = Counter::default(); |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
These type ascriptions are unfortunate. Can we get rid of them somehow?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
As far as I can tell, this is due to the default value of the Counter
A
trait parameter.
One thought I had was reducing the number of indirections through a Counter::new
method, though unfortunately, the compiler can not infer A
in such case either.
// TODO: Instead of depending on dynamic dispatch for all metrics, we could use | ||
// static dispatch for the most common ones and only fall back to dynamic | ||
// dispatch. That said, this needs to be proven performant in a benchmark first. | ||
/// Super trait representing an abstract Prometheus metric. | ||
#[cfg(not(feature = "protobuf"))] | ||
pub trait Metric: | ||
crate::encoding::text::EncodeMetric + Send + Sync + std::fmt::Debug + 'static | ||
{ | ||
} | ||
|
||
/// Super trait representing an abstract Prometheus metric. | ||
#[cfg(feature = "protobuf")] | ||
pub trait Metric: | ||
crate::encoding::text::EncodeMetric | ||
+ crate::encoding::proto::EncodeMetric | ||
+ Send | ||
+ Sync | ||
+ std::fmt::Debug | ||
+ 'static | ||
{ | ||
} | ||
|
||
#[cfg(not(feature = "protobuf"))] | ||
impl<T> Metric for T where | ||
T: crate::encoding::text::EncodeMetric + Send + Sync + std::fmt::Debug + 'static | ||
{ | ||
} | ||
|
||
#[cfg(feature = "protobuf")] | ||
impl<T> Metric for T where | ||
T: crate::encoding::text::EncodeMetric | ||
+ crate::encoding::proto::EncodeMetric | ||
+ Send | ||
+ Sync | ||
+ std::fmt::Debug | ||
+ 'static | ||
{ | ||
} |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is a bit hacky but I guess it works? :D
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Agreed. Though I am not sure how to do it differently.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Features are supposed to be additive, this is not additive.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Functionality-wise for the end user, it is additive. There is more discussion further down in how else we could solve this!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
If I care about only text encoding and my metric type implements only crate::encoding::text::EncodeMetric
, and some dependency enables the protobuf
feature, then my type won't implement Metric
anymore.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It will. The one defined on line 382.
There will always be a Metric
trait, just with different supertraits basd on the activated feature.
I can't think of a situation in which this breaks something but I agree that it is not clean.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It won't, that's not how it works. If I implement all the supertraits but crate::encoding::proto::EncodeMetric
and I rely on my type implementing Metric
, my code will break if a third-party enables the "protobuf" feature, thus making the "protobuf" feature non-additive. Adding a supertrait when a feature is enabled makes that feature non-additive.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Okay, yeah. It is technically breaking. But the set of prometheus metrics is fixed right? Why would you implement the trait yourself? What am I missing?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I've already implemented my own Family
and my own Counter
.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for raising this @nox.
I think the way to go is a single EncodeMetric
trait which then allows encoding:text
and encoding::protobuf
to traverse a metric via the visitor pattern as suggested below by @thomaseizinger.
The usage of serde is currently explored in #97. If I am not mistaken, this can happen in parallel, right? Serializing (serde) and storing ( |
…to dyn-disp-metric
You might have misunderstood me :)
With this PR, we are facing the same problem as serde does: We want to have types ( We could solve this by copying serde's design of an abstract In other words, instead of having multiple trait Encoder {
fn encode_int_counter(&mut self, int_value: u64) -> Result<()>;
fn encode_double_counter(&mut self, int_value: f64) -> Result<()>;
fn encode_int_gauge(&mut self, int_value: i64) -> Result<()>;
fn encode_labels(&mut self, labels: &[String]) -> Result<()>;
// etc
} Another design might be something like: trait Encoder {
fn start_encode_counter(&mut self) -> Result<CounterEncoder>;
// etc
}
impl CounterEncoder<'encoder> {
fn add_labels(&mut self, labels: &[String]);
fn set_int_value(&mut self, int_value: u64);
fn set_double_value(&mut self, double_value: f64);
fn finish(self) -> Result<()>
}
impl Encode for Counter {
fn encode<E>(&mut, encoder: &mut E) where E: Encoder -> Result<()> {
let mut counter_encoder = encoder.start_encoder_counter();
counter_encoder.add_labels(&["foo"]).set_int_value(self.value).finish()
}
} In regards to #97, I don't think an approach that is fully generic over |
I agree with @thomaseizinger that using Prometheus defines a set of types (counter, gauge, histogram, summary) which can be encoded. Core Prometheus defines one encoding format (text) and OpenMetrics another (binary) over those core types. No other valid encodings exist; there is no JSON encoding of a Prometheus counter, for example. The transformation between a Prometheus type and its encoded form is code defined by the format, and "custom" for the type. For example, a Rust type implementing a Prometheus gauge may have an OpenMetrics encoding which is different than its general Protobuf encoding, and the presence of a Protobuf encoding on a type doesn't mean that encoding is valid for OpenMetrics. Likewise, a type implementing a Prometheus counter may have a Prometheus text encoding which is different than its general text encoding, and the presence of a text encoding on a type doesn't mean that encoding is valid for Prometheus. |
👍 for not adopting I like the idea of a single I think this is orthogonal to this pull request. I.e. this pull request is about fixing I suggest we keep this pull request as is and in a follow-up pull request consolidate the two Objections? |
Fine with me. I just thought a bit more about how we can adopt this design and we will have to take inspiration from https://github.com/dtolnay/miniserde as the static dispatch approach from With saying that, could we get away with having an enum of all metrics and store that without boxing? :) |
Unfortunately not. Or I don't know how to do that. The reason being:
We could drop the generic parameters here as well, and only provide a limited set of |
So a Do we need to be generic over all atomics? |
Correct.
Maybe. I am undecided on it. Also |
Fair enough. Yeah it would just be another optimization. We should be fine if we box the entire metric up. |
Following up on above's suggestion in #100 (comment). The |
While I do see value in users being able to bring their own metrics, I don't think users will bring their own output format. Thus we can likely get around the above trait object safety issue by multiplexing output formats via an |
Instead of an enum, |
In that case none of the methods on I have not yet found a way around this issue.
True. Though that might be worth it. |
I'm probably missing something here, but this doesn't (immediately) make sense to me. Prometheus metrics are types, not traits. A user type wouldn't implement a counter, it would update a counter: has-a, rather than is-a. Right? |
I don't quite understand what you are getting at. Every metric needs to implement |
As mentioned in this previous comment, I've already implemented my own counter and my own family. That they wrap types from this crate is an implementation detail, the important part is that my custom types implement |
Ah, apologies for being vague. Let me try again: if you're writing a Prometheus client library (i.e. this crate) then the idea is that you're providing "every metric" yourself, each as a specific concrete type. Metrics are precisely specified, and their behavior isn't (or, shouldn't be) up to interpretation by implementations. Users shouldn't be bringing their own types. They should be using yours.
Your counter implementation violates the Prometheus spec, I think, right? So it isn't really a counter, even though it may satisfy the relevant interface in this client library. This is an example of the kind of outcome that I claim should be specifically prevented. YMMV 🤷 |
The OpenMetrics spec, sure. Other prometheus clients so far don't care about suffixes. If the ability to make my own unsuffixed counter goes away, I'll simply not use this crate anymore. |
Yes, I agree with you. The way I see it is that "bring your own metric" is likely to be possible but I don't think it needs to be a goal of the library. |
The docs on naming state that
https://prometheus.io/docs/practices/naming/#metric-names
This is at least superficially confusing. Why? A counter in the context of Prometheus is, by definition, suffixed as described above. There's no, like, law, or parser validator, that rejects counters that don't meet the specification, I guess. But it's still well-defined, and there's not really any room for interpretation. At least, as far as I understand the docs. |
Literally not a spec, this document starts with:
(Emphasis mine) |
As this client library exists in the Prometheus org, I assume it will abide and enforce Prometheus best practices. If that's not the case, then I suppose it should live somewhere else. But whether spec or suggestion, MUST or SHOULD, the things under discussion here, suffixing certainly included, represent no meaningful hardship to users, and carry no cost versus alternatives. Absent specific cause, there's no reason not to play by the rules. |
I've already explained that we have dozens of dozens of dashboards using unsuffixed metrics and forking this crate will be cheaper than migrating those dashboards. |
You completely removed the ability to define custom metrics to avoid the |
I am sorry for the trouble @nox. I decided to follow the OpenMetrics specification. In the long run I hope for the ecosystem (e.g. your dashboards) to converge on that specification. In the meantime, I don't see a way around forking. |
Thanks, we will stay on prometheus-client 0.18 for now. |
Instead of being generic over the metric type on
Registry
, use dynamic dispatch.On the upside this significantly simplifies type signatures exposed to the user. On the downside this requires users to always use dynamic dispatch and requires all metrics to implement auxiliary trait
Debug
and auto traitsSend
andSync
.Initially suggested in #82 (comment)
Would replace #99 //CC @ackintosh @adamchalmers
Happy for alternative suggestions. //CC @thomaseizinger in case you are interested and have ideas.