-
Notifications
You must be signed in to change notification settings - Fork 196
Metrics: Add Cumulative APIs. #1848
Metrics: Add Cumulative APIs. #1848
Conversation
rghetia
left a comment
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.
few nits related to since annotations.
LGTM otherwise.
|
|
||
| /** | ||
| * Derived Double Cumulative metric, to report cumulative measurement of a double value. Cumulative | ||
| * values can go up or stay the same, but can never go down. The cumulative values cannot be |
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.
"The cumulative values" -> "Cumulative values" - similarly below.
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.
Updated.
|
|
||
| /** | ||
| * Builds a new long cumulative to be added to the registry. This is more convenient form when you | ||
| * want to manually increase values as per your service requirements. |
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 more convenient form" -> "This form is more convenient" or "This is a more convenient form" - here and below.
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.
SG, updated.
| * @since 0.21 | ||
| */ | ||
| @ExperimentalApi | ||
| public abstract LongCumulative addLongCumulative(String name, MetricOptions options); |
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.
Why the name add.. - seems like it's only building something not adding it to anything.
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's both building a new *Cumulative object and adding it to the MetricRegistry so that all metric readers can read it from the MetricRegistry.
|
Thanks! Implementation will be in a follow-up PR. |
Updates #1815.
Although the Spec PR (census-instrumentation/opencensus-specs#254) hasn't been submitted, Cumulative APIs have already been added to Go and Node. This PR adds the Cumulative APIs in Java similar to Go (census-instrumentation/opencensus-go#1090).
Most are a copy-and-paste from Gauge APIs since they are very similar.