2021-06-11 22:25:56 +02:00
|
|
|
// 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.
|
|
|
|
|
2021-09-28 04:37:26 +02:00
|
|
|
package otlpmetric // import "go.opentelemetry.io/otel/exporters/otlp/otlpmetric"
|
2021-06-11 22:25:56 +02:00
|
|
|
|
|
|
|
import (
|
|
|
|
"context"
|
|
|
|
"errors"
|
|
|
|
"sync"
|
|
|
|
|
|
|
|
"go.opentelemetry.io/otel/exporters/otlp/otlpmetric/internal/metrictransform"
|
2021-10-14 18:06:22 +02:00
|
|
|
"go.opentelemetry.io/otel/metric/sdkapi"
|
2021-12-13 22:13:03 +02:00
|
|
|
"go.opentelemetry.io/otel/sdk/metric/export"
|
|
|
|
"go.opentelemetry.io/otel/sdk/metric/export/aggregation"
|
2021-08-13 00:44:58 +02:00
|
|
|
"go.opentelemetry.io/otel/sdk/resource"
|
2021-06-11 22:25:56 +02:00
|
|
|
)
|
|
|
|
|
|
|
|
var (
|
|
|
|
errAlreadyStarted = errors.New("already started")
|
|
|
|
)
|
|
|
|
|
|
|
|
// Exporter exports metrics data in the OTLP wire format.
|
|
|
|
type Exporter struct {
|
2021-10-15 20:18:36 +02:00
|
|
|
client Client
|
|
|
|
temporalitySelector aggregation.TemporalitySelector
|
2021-06-11 22:25:56 +02:00
|
|
|
|
|
|
|
mu sync.RWMutex
|
|
|
|
started bool
|
|
|
|
|
|
|
|
startOnce sync.Once
|
|
|
|
stopOnce sync.Once
|
|
|
|
}
|
|
|
|
|
|
|
|
// Export exports a batch of metrics.
|
2021-12-13 22:13:03 +02:00
|
|
|
func (e *Exporter) Export(ctx context.Context, res *resource.Resource, ilr export.InstrumentationLibraryReader) error {
|
2021-09-27 17:51:47 +02:00
|
|
|
rm, err := metrictransform.InstrumentationLibraryReader(ctx, e, res, ilr, 1)
|
2021-06-11 22:25:56 +02:00
|
|
|
if err != nil {
|
|
|
|
return err
|
|
|
|
}
|
2021-09-27 17:51:47 +02:00
|
|
|
if rm == nil {
|
2021-06-11 22:25:56 +02:00
|
|
|
return nil
|
|
|
|
}
|
|
|
|
|
2021-09-27 17:51:47 +02:00
|
|
|
// TODO: There is never more than one resource emitted by this
|
|
|
|
// call, as per the specification. We can change the
|
|
|
|
// signature of UploadMetrics correspondingly. Here create a
|
|
|
|
// singleton list to reduce the size of the current PR:
|
2022-01-04 20:14:03 +02:00
|
|
|
return e.client.UploadMetrics(ctx, rm)
|
2021-06-11 22:25:56 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
// Start establishes a connection to the receiving endpoint.
|
|
|
|
func (e *Exporter) Start(ctx context.Context) error {
|
|
|
|
var err = errAlreadyStarted
|
|
|
|
e.startOnce.Do(func() {
|
|
|
|
e.mu.Lock()
|
|
|
|
e.started = true
|
|
|
|
e.mu.Unlock()
|
|
|
|
err = e.client.Start(ctx)
|
|
|
|
})
|
|
|
|
|
|
|
|
return err
|
|
|
|
}
|
|
|
|
|
|
|
|
// Shutdown flushes all exports and closes all connections to the receiving endpoint.
|
|
|
|
func (e *Exporter) Shutdown(ctx context.Context) error {
|
|
|
|
|
|
|
|
e.mu.RLock()
|
|
|
|
started := e.started
|
|
|
|
e.mu.RUnlock()
|
|
|
|
|
|
|
|
if !started {
|
|
|
|
return nil
|
|
|
|
}
|
|
|
|
|
|
|
|
var err error
|
|
|
|
|
|
|
|
e.stopOnce.Do(func() {
|
|
|
|
err = e.client.Stop(ctx)
|
|
|
|
e.mu.Lock()
|
|
|
|
e.started = false
|
|
|
|
e.mu.Unlock()
|
|
|
|
})
|
|
|
|
|
|
|
|
return err
|
|
|
|
}
|
|
|
|
|
2021-10-15 20:18:36 +02:00
|
|
|
func (e *Exporter) TemporalityFor(descriptor *sdkapi.Descriptor, kind aggregation.Kind) aggregation.Temporality {
|
|
|
|
return e.temporalitySelector.TemporalityFor(descriptor, kind)
|
2021-06-11 22:25:56 +02:00
|
|
|
}
|
|
|
|
|
2021-12-13 22:13:03 +02:00
|
|
|
var _ export.Exporter = (*Exporter)(nil)
|
2021-06-11 22:25:56 +02:00
|
|
|
|
|
|
|
// New constructs a new Exporter and starts it.
|
|
|
|
func New(ctx context.Context, client Client, opts ...Option) (*Exporter, error) {
|
|
|
|
exp := NewUnstarted(client, opts...)
|
|
|
|
if err := exp.Start(ctx); err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
return exp, nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// NewUnstarted constructs a new Exporter and does not start it.
|
|
|
|
func NewUnstarted(client Client, opts ...Option) *Exporter {
|
|
|
|
cfg := config{
|
2021-10-15 20:18:36 +02:00
|
|
|
// Note: the default TemporalitySelector is specified
|
2021-06-11 22:25:56 +02:00
|
|
|
// as Cumulative:
|
|
|
|
// https://github.com/open-telemetry/opentelemetry-specification/issues/731
|
2021-10-15 20:18:36 +02:00
|
|
|
temporalitySelector: aggregation.CumulativeTemporalitySelector(),
|
2021-06-11 22:25:56 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
for _, opt := range opts {
|
2022-02-01 23:51:23 +02:00
|
|
|
cfg = opt.apply(cfg)
|
2021-06-11 22:25:56 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
e := &Exporter{
|
2021-10-15 20:18:36 +02:00
|
|
|
client: client,
|
|
|
|
temporalitySelector: cfg.temporalitySelector,
|
2021-06-11 22:25:56 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
return e
|
|
|
|
}
|