Mu.Instrumentation.Tracing

This module injects distributed tracing for Mu servers. Currently it only supports Zipkin as backend.

In order to use this module, you need to follow these steps:

1. Establish a connection with newZipkin.
2. Wrap the server using zipkin, giving information for the root.
3. Run the server using the transformer version of your protocol, like |grpcAppTrans|.

Distributed tracing

data MuTracing

Constructors

MuTracing

Fields

• samplingPolicy :: SamplingPolicy
• rootName :: Text

zipkin :: (MonadIO m, MonadTrace m) => MuTracing -> ServerT chn i p m topHs -> ServerT chn i p m topHs

Wraps a server to do distributed tracing using Zipkin as backend.

runZipkin :: Zipkin -> TraceT m a -> m a

Runs with a given Zipkin connection. You can create one with newZipkin.

Establish connection

newZipkin :: Settings -> IO Zipkin

Create a new connection to Zipkin.

defaultZipkinSettings :: Settings

data Settings

Zipkin creation settings.

Constructors

Settings

Fields

• settingsHostname :: !(Maybe HostName)

  The Zipkin server's hostname, defaults to localhost if unset.

• settingsPort :: !(Maybe PortNumber)

  The port the Zipkin server is listening on, defaults to 9411 if unset.

• settingsEndpoint :: !(Maybe Endpoint)

  Local endpoint included in all published spans.

• settingsManager :: !(Maybe Manager)

  An optional HTTP manager to use for publishing spans on the Zipkin server.

• settingsPublishPeriod :: !(Maybe NominalDiffTime)

  If set to a positive value, traces will be flushed in the background every such period.

Instances

IsString Settings

Generates settings with the given string as hostname.

Defined in Monitor.Tracing.Zipkin

Methods

fromString :: String -> Settings

Useful re-exports

module Monitor.Tracing