observability

Documentation

Overview

Package observability provides a tracer and a histogram to measure all incoming requests to the system.

Introduction

Observability is crucial to the stability of the system. The three pillars of the observabilities consist of logging, tracing and metrics. Since logging is provided in Package logging, this package mainly focus on tracing and metrics.

Integration

Add the observabilities to core:

var c *core.C = core.New()
c.provide(observability.Providers())

See example for usage.

Example

c := core.New()
c.ProvideEssentials()
c.Provide(observability.Providers())
c.Invoke(func(tracer opentracing.Tracer, metrics metrics.Histogram) {
	start := time.Now()
	span := tracer.StartSpan("test")
	time.Sleep(time.Second)
	span.Finish()
	metrics.With("module", "service", "method").Observe(time.Since(start).Seconds())
})

Index

• func ProvideHistogramMetrics(appName contract.AppName, env contract.Env) metrics.Histogram
• func ProvideJaegerLogAdapter(l log.Logger) jaeger.Logger
• func ProvideOpentracing(appName contract.AppName, env contract.Env, log jaeger.Logger, ...) (opentracing.Tracer, func(), error)
• func Providers() di.Deps
• type JaegerLogAdapter
  • func (l JaegerLogAdapter) Error(msg string)
  • func (l JaegerLogAdapter) Infof(msg string, args ...interface{})

Examples

• Package

Functions

func ProvideHistogramMetrics

func ProvideHistogramMetrics(appName contract.AppName, env contract.Env) metrics.Histogram

ProvideHistogramMetrics returns a metrics.Histogram that is designed to measure incoming requests to the system. Note it has three labels: "module", "service", "method". If any label is missing, the system will panic.

func ProvideJaegerLogAdapter

func ProvideJaegerLogAdapter(l log.Logger) jaeger.Logger

ProvideJaegerLogAdapter returns a valid jaeger.Logger.

func ProvideOpentracing

func ProvideOpentracing(
	appName contract.AppName,
	env contract.Env,
	log jaeger.Logger,
	conf contract.ConfigAccessor,
) (opentracing.Tracer, func(), error)

ProvideOpentracing provides a opentracing.Tracer.

func Providers

func Providers() di.Deps

Providers returns a set of providers available in package observability

Depends On:
	log.Logger
	contract.ConfigAccessor
	contract.AppName
	contract.Env
Provides:
	opentracing.Tracer
	metrics.Histogram

Types

type JaegerLogAdapter

type JaegerLogAdapter struct {
	Logging log.Logger
}

JaegerLogAdapter is an adapter that bridges kitlog and Jaeger.

func (JaegerLogAdapter) Error

func (l JaegerLogAdapter) Error(msg string)

Error implements jaeger's logger

func (JaegerLogAdapter) Infof

func (l JaegerLogAdapter) Infof(msg string, args ...interface{})

Infof implements jaeger's logger