mirror of
https://github.com/open-telemetry/opentelemetry-go.git
synced 2025-01-26 03:52:03 +02:00
1f9cc3036b
* Split metric inst config Instead of having the same configuration for both the Synchronous and Asynchronous instruments, use specific options for both. * Use Async/Sync opt for appropriate inst * Update noop inst providers * Update internal global impl * Update sdk * Remove unused method for callbackOption * Test instrument configuration * Lint imports * Add changes to changelog * Refactor callbacks and further split opts Define callbacks to return the value observed. Because of the different types returned for different observables, the callbacks and options are move to the sync/async packages. * Update noop impl * Fix example_test.go * Fix internal impl * Update Callbacks Return observations for distinct attr sets. * Refactor common code in sdk/metric inst provider * Update examples and prom exporter * Generalize callback * Update changelog * Add unit tests for callback * Add meter tests for cbacks on creation * Rename Observations to Measurements * Update Callback to accept an Observer * Update SDK impl * Move conf to instrument pkg * Apply suggestions from code review
91 lines
2.4 KiB
Go
91 lines
2.4 KiB
Go
// Copyright The OpenTelemetry Authors
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
package instrument // import "go.opentelemetry.io/otel/metric/instrument"
|
|
|
|
import "go.opentelemetry.io/otel/metric/unit"
|
|
|
|
// Asynchronous instruments are instruments that are updated within a Callback.
|
|
// If an instrument is observed outside of it's callback it should be an error.
|
|
//
|
|
// This interface is used as a grouping mechanism.
|
|
type Asynchronous interface {
|
|
asynchronous()
|
|
}
|
|
|
|
// Synchronous instruments are updated in line with application code.
|
|
//
|
|
// This interface is used as a grouping mechanism.
|
|
type Synchronous interface {
|
|
synchronous()
|
|
}
|
|
|
|
// Option applies options to all instruments.
|
|
type Option interface {
|
|
Float64ObserverOption
|
|
Int64ObserverOption
|
|
Float64Option
|
|
Int64Option
|
|
}
|
|
|
|
type descOpt string
|
|
|
|
func (o descOpt) applyFloat64(c Float64Config) Float64Config {
|
|
c.description = string(o)
|
|
return c
|
|
}
|
|
|
|
func (o descOpt) applyInt64(c Int64Config) Int64Config {
|
|
c.description = string(o)
|
|
return c
|
|
}
|
|
|
|
func (o descOpt) applyFloat64Observer(c Float64ObserverConfig) Float64ObserverConfig {
|
|
c.description = string(o)
|
|
return c
|
|
}
|
|
|
|
func (o descOpt) applyInt64Observer(c Int64ObserverConfig) Int64ObserverConfig {
|
|
c.description = string(o)
|
|
return c
|
|
}
|
|
|
|
// WithDescription sets the instrument description.
|
|
func WithDescription(desc string) Option { return descOpt(desc) }
|
|
|
|
type unitOpt unit.Unit
|
|
|
|
func (o unitOpt) applyFloat64(c Float64Config) Float64Config {
|
|
c.unit = unit.Unit(o)
|
|
return c
|
|
}
|
|
|
|
func (o unitOpt) applyInt64(c Int64Config) Int64Config {
|
|
c.unit = unit.Unit(o)
|
|
return c
|
|
}
|
|
|
|
func (o unitOpt) applyFloat64Observer(c Float64ObserverConfig) Float64ObserverConfig {
|
|
c.unit = unit.Unit(o)
|
|
return c
|
|
}
|
|
|
|
func (o unitOpt) applyInt64Observer(c Int64ObserverConfig) Int64ObserverConfig {
|
|
c.unit = unit.Unit(o)
|
|
return c
|
|
}
|
|
|
|
// WithUnit sets the instrument unit.
|
|
func WithUnit(u unit.Unit) Option { return unitOpt(u) }
|