mirror of
https://github.com/open-telemetry/opentelemetry-go.git
synced 2024-12-12 10:04:29 +02:00
452256cbf4
* Consolidate stdout exporter * Move config to own file and match project standard * Abstract Exporter into unified struct * Rename trace part of the exporter * Update import paths and configuration * Update tests * Update InstallNewPipeline to not return traceProvider It is a registered global, access it that way. * Update example_test * Update docs * Update example to be for whole package * Update metric output Closer match the span output. * Clean up span output Print as a batch and cleanup marshaling. * Correct spelling error in doc * Add Exporters README * Update Changelog * Propagate changes to rest of project * Lint fixes * Fix example test in metric SDK * Add disable config options for trace and metric Co-authored-by: Liz Fong-Jones <lizf@honeycomb.io>
95 lines
2.7 KiB
Go
95 lines
2.7 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 stdout
|
|
|
|
import (
|
|
"go.opentelemetry.io/otel/api/global"
|
|
apitrace "go.opentelemetry.io/otel/api/trace"
|
|
"go.opentelemetry.io/otel/sdk/export/metric"
|
|
"go.opentelemetry.io/otel/sdk/export/trace"
|
|
"go.opentelemetry.io/otel/sdk/metric/controller/push"
|
|
"go.opentelemetry.io/otel/sdk/metric/selector/simple"
|
|
sdktrace "go.opentelemetry.io/otel/sdk/trace"
|
|
)
|
|
|
|
type Exporter struct {
|
|
traceExporter
|
|
metricExporter
|
|
}
|
|
|
|
var (
|
|
_ metric.Exporter = &Exporter{}
|
|
_ trace.SpanSyncer = &Exporter{}
|
|
_ trace.SpanBatcher = &Exporter{}
|
|
)
|
|
|
|
// NewExporter creates an Exporter with the passed options.
|
|
func NewExporter(options ...Option) (*Exporter, error) {
|
|
config, err := Configure(options...)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return &Exporter{
|
|
traceExporter: traceExporter{config},
|
|
metricExporter: metricExporter{config},
|
|
}, nil
|
|
}
|
|
|
|
// NewExportPipeline creates a complete export pipeline with the default
|
|
// selectors, processors, and trace registration. It is the responsibility
|
|
// of the caller to stop the returned push Controller.
|
|
func NewExportPipeline(exportOpts []Option, pushOpts []push.Option) (apitrace.Provider, *push.Controller, error) {
|
|
exporter, err := NewExporter(exportOpts...)
|
|
if err != nil {
|
|
return nil, nil, err
|
|
}
|
|
|
|
tp, err := sdktrace.NewProvider(sdktrace.WithSyncer(exporter))
|
|
if err != nil {
|
|
return nil, nil, err
|
|
}
|
|
|
|
pusher := push.New(
|
|
simple.NewWithExactDistribution(),
|
|
exporter,
|
|
pushOpts...,
|
|
)
|
|
pusher.Start()
|
|
|
|
return tp, pusher, nil
|
|
}
|
|
|
|
// InstallNewPipeline creates a complete export pipelines with defaults and
|
|
// registers it globally. It is the responsibility of the caller to stop the
|
|
// returned push Controller.
|
|
//
|
|
// Typically this is called as:
|
|
//
|
|
// pipeline, err := stdout.InstallNewPipeline(stdout.Config{...})
|
|
// if err != nil {
|
|
// ...
|
|
// }
|
|
// defer pipeline.Stop()
|
|
// ... Done
|
|
func InstallNewPipeline(exportOpts []Option, pushOpts []push.Option) (*push.Controller, error) {
|
|
traceProvider, controller, err := NewExportPipeline(exportOpts, pushOpts)
|
|
if err != nil {
|
|
return controller, err
|
|
}
|
|
global.SetTraceProvider(traceProvider)
|
|
global.SetMeterProvider(controller.Provider())
|
|
return controller, err
|
|
}
|