Combined Metrics API updates for v0.3 (Add Observer instrument, remove Gauge instrument, etc.)#430
Conversation
|
I've added a couple pages of examples. |
jmacd
left a comment
There was a problem hiding this comment.
Thank you @yurishkuro. This is excellent feedback.
jmacd
left a comment
There was a problem hiding this comment.
I am interested in feedback on the discussion points here from the community.
bogdandrutu
left a comment
There was a problem hiding this comment.
Some small concerns, a lot of nits and requests to file issues to discuss more.
|
suggest renaming this PR because I have been not watching changes assuming the title made it self-evident what has been going on here. This looks way bigger than the title suggests. |
|
@dyladan You're right. I've added more detail in the title. |
|
@bogdandrutu Please take another look. |
|
@dyladan I looks big, you're right. There is a lot of philosophical justification here for removing Gauge and adding Observer. That's really just ab out all that's happened here. |
…e Gauge instrument, etc.) (open-telemetry#430) * Gauge/Observer rewrite pt 1 * Checkpoint * Checkpoint * Optional features restored * Update selection process * Update TOC * Reword intro para on standard impl * Add detail on label set * Add examples * Misspellings * Rewrite the introductory material * Add a section on time * Clarify 'standard implementation' and 'default interpretation' * Explain aggregations; Discourage timestamp use * Reword the metric event format * Update Counter and Measure * Update Observer (partial) * Remove options, discuss views API * Fixes * Fixes * Fixes * Rename BoundTimer * Typos and suggestions * Reword global Meter * Rearrange early paragraphs * Use _run time_ and _simultaneous_ * Rearrange early paragraphs (again) * Define _run time_ * These * Iterate * Remove a TODO * More on global/named meters * Difference, Capture * Timer wording * Explicit timestamp * Rewrite simultaneous * Example: active requests * Synchronously * Wording * Example using correlation context * Detail on WithKeys * Counter is a special case * Counter fixes; typo * Typo * Split the leading example into Counter and Measure cases * Remove poor example * Update TOC * Add note about Observer and Context * Add note about context-freedom in Observer * Run MDL * WithRecommendedKeys * Typo * Address most of Bogdan's feedback * Typo Co-authored-by: Bogdan Drutu <lazy@splunk.com>
…e Gauge instrument, etc.) (open-telemetry#430) * Gauge/Observer rewrite pt 1 * Checkpoint * Checkpoint * Optional features restored * Update selection process * Update TOC * Reword intro para on standard impl * Add detail on label set * Add examples * Misspellings * Rewrite the introductory material * Add a section on time * Clarify 'standard implementation' and 'default interpretation' * Explain aggregations; Discourage timestamp use * Reword the metric event format * Update Counter and Measure * Update Observer (partial) * Remove options, discuss views API * Fixes * Fixes * Fixes * Rename BoundTimer * Typos and suggestions * Reword global Meter * Rearrange early paragraphs * Use _run time_ and _simultaneous_ * Rearrange early paragraphs (again) * Define _run time_ * These * Iterate * Remove a TODO * More on global/named meters * Difference, Capture * Timer wording * Explicit timestamp * Rewrite simultaneous * Example: active requests * Synchronously * Wording * Example using correlation context * Detail on WithKeys * Counter is a special case * Counter fixes; typo * Typo * Split the leading example into Counter and Measure cases * Remove poor example * Update TOC * Add note about Observer and Context * Add note about context-freedom in Observer * Run MDL * WithRecommendedKeys * Typo * Address most of Bogdan's feedback * Typo Co-authored-by: Bogdan Drutu <lazy@splunk.com>
This specifies the changes described in these OTEPs:
open-telemetry/oteps#80
open-telemetry/oteps#72