metrics

Documentation

Index

• Constants
• func ConfigureOpenTelemetry(opts ...Option) error
• func ForceFlush(ctx context.Context) error
• func ReportError(ctx context.Context, err error, opts ...trace.EventOption)
• func ReportPanic(ctx context.Context)
• func Shutdown(ctx context.Context) error
• func TracerProvider() *sdktrace.TracerProvider
• type DSN
  • func ParseDSN(dsnStr string) (*DSN, error)
  • func (dsn *DSN) OTLPEndpoint() string
  • func (dsn *DSN) String() string
• type Metric
• type MetricsOption
  • func WithMetricOption(options ...metric.Option) MetricsOption
  • func WithMetricsDisabled() MetricsOption
  • func WithMetricsEnabled(on bool) MetricsOption
• type Option
  • func WithDSN(dsn string) Option
  • func WithDeploymentEnvironment(env string) Option
  • func WithResource(resource *resource.Resource) Option
  • func WithResourceAttributes(attrs ...attribute.KeyValue) Option
  • func WithResourceDetectors(detectors ...resource.Detector) Option
  • func WithServiceName(serviceName string) Option
  • func WithServiceVersion(serviceVersion string) Option
  • func WithTLSConfig(tlsConf *tls.Config) Option
• type TracingOption
  • func WithBatchSpanProcessorOption(opts ...sdktrace.BatchSpanProcessorOption) TracingOption
  • func WithPrettyPrintSpanExporter() TracingOption
  • func WithPropagator(propagator propagation.TextMapPropagator) TracingOption
  • func WithTextMapPropagator(propagator propagation.TextMapPropagator) TracingOption
  • func WithTraceSampler(sampler sdktrace.Sampler) TracingOption
  • func WithTracerProvider(provider *sdktrace.TracerProvider) TracingOption
  • func WithTracingDisabled() TracingOption
  • func WithTracingEnabled(on bool) TracingOption

Constants

const (
	MetricEdgeMsgIn  = "tiny.edge.msg.in"
	MetricEdgeMsgOut = "tiny.edge.msg.out"
)

Functions

func ConfigureOpenTelemetry

func ConfigureOpenTelemetry(opts ...Option) error

ConfigureOpenTelemetry configures OpenTelemetry. You can use OTLP_DISABLED env var to completely skip open telemetry configuration.

func ForceFlush

func ForceFlush(ctx context.Context) error

func ReportError

func ReportError(ctx context.Context, err error, opts ...trace.EventOption)

func ReportPanic

func ReportPanic(ctx context.Context)

func Shutdown

func Shutdown(ctx context.Context) error

func TracerProvider

func TracerProvider() *sdktrace.TracerProvider

Types

type DSN

type DSN struct {
	Scheme   string
	Host     string
	GRPCPort string
	Token    string
	// contains filtered or unexported fields
}

func ParseDSN

func ParseDSN(dsnStr string) (*DSN, error)

func (*DSN) OTLPEndpoint

func (dsn *DSN) OTLPEndpoint() string

func (*DSN) String

func (dsn *DSN) String() string

type Metric

type Metric string

type MetricsOption

type MetricsOption interface {
	Option
	// contains filtered or unexported methods
}

func WithMetricOption

func WithMetricOption(options ...metric.Option) MetricsOption

func WithMetricsDisabled

func WithMetricsDisabled() MetricsOption

WithMetricsDisabled disables metrics.

func WithMetricsEnabled

func WithMetricsEnabled(on bool) MetricsOption

WithMetricsEnabled can be used to enable/disable metrics.

type Option

type Option interface {
	// contains filtered or unexported methods
}

func WithDSN

func WithDSN(dsn string) Option

WithDSN configures a data source name that is used to connect `https://<token>@api.tinysystems.io`.

The default is to use OTLP_DSN environment variable.

func WithDeploymentEnvironment

func WithDeploymentEnvironment(env string) Option

WithDeploymentEnvironment configures `deployment.environment` resource attribute, for example, `production`.

func WithResource

func WithResource(resource *resource.Resource) Option

WithResource configures a resource that describes an entity that produces telemetry, for example, such attributes as host.name and service.name. All produced spans and metrics will have these attributes.

WithResource overrides and replaces any other resource attributes.

func WithResourceAttributes

func WithResourceAttributes(attrs ...attribute.KeyValue) Option

WithResourceAttributes configures resource attributes that describe an entity that produces telemetry, for example, such attributes as host.name, service.name, etc.

The default is to use `OTEL_RESOURCE_ATTRIBUTES` env var, for example, `OTEL_RESOURCE_ATTRIBUTES=service.name=myservice,service.version=1.0.0`.

func WithResourceDetectors

func WithResourceDetectors(detectors ...resource.Detector) Option

WithResourceDetectors adds detectors to be evaluated for the configured resource.

func WithServiceName

func WithServiceName(serviceName string) Option

WithServiceName configures `service.name` resource attribute.

func WithServiceVersion

func WithServiceVersion(serviceVersion string) Option

WithServiceVersion configures `service.version` resource attribute, for example, `1.0.0`.

func WithTLSConfig

func WithTLSConfig(tlsConf *tls.Config) Option

type TracingOption

type TracingOption interface {
	Option
	// contains filtered or unexported methods
}

func WithBatchSpanProcessorOption

func WithBatchSpanProcessorOption(opts ...sdktrace.BatchSpanProcessorOption) TracingOption

WithBatchSpanProcessorOption specifies options used to created BatchSpanProcessor.

func WithPrettyPrintSpanExporter

func WithPrettyPrintSpanExporter() TracingOption

WithPrettyPrintSpanExporter adds a span exproter that prints spans to stdout. It is useful for debugging or demonstration purposes.

func WithPropagator

func WithPropagator(propagator propagation.TextMapPropagator) TracingOption

WithPropagator sets the global TextMapPropagator used by OpenTelemetry. The default is propagation.TraceContext and propagation.Baggage.

func WithTextMapPropagator

func WithTextMapPropagator(propagator propagation.TextMapPropagator) TracingOption

WithTextMapPropagator is an alias for WithPropagator.

func WithTraceSampler

func WithTraceSampler(sampler sdktrace.Sampler) TracingOption

WithTraceSampler configures a span sampler.

func WithTracerProvider

func WithTracerProvider(provider *sdktrace.TracerProvider) TracingOption

WithTracerProvider overwrites the default tracer provider.

When this option is used, you might need to call otel.SetTracerProvider to register the provider as the global trace provider.

func WithTracingDisabled

func WithTracingDisabled() TracingOption

WithTracingDisabled disables tracing.

func WithTracingEnabled

func WithTracingEnabled(on bool) TracingOption

WithTracingEnabled can be used to enable/disable tracing.