Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/evolution-gaming/stracer

Tools for tracing and span reporting
https://github.com/evolution-gaming/stracer

cats-effect jaeger kafka scala tagless-final thrift zipkin

Last synced: about 2 months ago
JSON representation

Tools for tracing and span reporting

Host: GitHub
URL: https://github.com/evolution-gaming/stracer
Owner: evolution-gaming
License: mit
Created: 2019-03-20T13:19:35.000Z (almost 6 years ago)
Default Branch: master
Last Pushed: 2024-07-18T10:25:14.000Z (6 months ago)
Last Synced: 2024-07-18T13:06:06.084Z (6 months ago)
Topics: cats-effect, jaeger, kafka, scala, tagless-final, thrift, zipkin
Language: Scala
Size: 262 KB
Stars: 6
Watchers: 10
Forks: 3
Open Issues: 37
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # STracer

[![Build Status](https://github.com/evolution-gaming/stracer/workflows/CI/badge.svg)](https://github.com/evolution-gaming/stracer/actions?query=workflow:CI+branch:master)

[![Coverage Status](https://coveralls.io/repos/github/evolution-gaming/stracer/badge.svg?branch=master)](https://coveralls.io/github/evolution-gaming/stracer?branch=master)

[![Codacy Badge](https://api.codacy.com/project/badge/Grade/4b3e6d6ca1224b1bb7004b18760f7fa8)](https://www.codacy.com/app/evolution-gaming/stracer?utm_source=github.com&utm_medium=referral&utm_content=evolution-gaming/stracer&utm_campaign=Badge_Grade)

[![Version](https://img.shields.io/badge/version-click-blue)](https://evolution.jfrog.io/artifactory/api/search/latestVersion?g=com.evolutiongaming&a=stracer_2.13&repos=public)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellowgreen.svg)](https://opensource.org/licenses/MIT)

Library for distributed tracing in Scala

## Span

```scala

final case class Span(

  traceId: TraceId,

  spanId: SpanId,

  name: String,

  timestamp: Instant,

  kind: Option[Kind] = None,

  duration: Option[FiniteDuration] = None,

  remoteEndpoint: Option[Endpoint] = None,

  tags: Tags = List.empty,

  shared: Option[Boolean] = None,

  parentId: Option[SpanId])

```

## Trace

```scala

final case class Trace(

  traceId: TraceId,

  spanId: SpanId,

  parentId: Option[SpanId],

  timestamp: Option[Instant],

  sampling: Option[Sampling] = None)

``` 

 

## Tracer

Generate SpanId and Trace 

```scala

trait Tracer[F[_]] {

  def trace(sampling: Option[Sampling] = None): F[Option[Trace]]

}

```

## ReportSpan

We provide [Kafka](http://kafka.apache.org) based implementation, which uses `SpanBytesEncoder.THRIFT` from [Zipkin](http://zipkin.io/) to encode spans.

It is also compatible with [Jaeger](https://www.jaegertracing.io) & [Ingester](https://www.jaegertracing.io/docs/1.8/deployment/#ingester)  

Since version `5.0.0` this implementation is available in separate module `stracer-kafka`.

```scala

trait ReportSpan[F[_]] {

  def apply(span: Span): F[Unit]

}

```

 

## Setup

```scala

addSbtPlugin("com.evolution" % "sbt-artifactory-plugin" % "0.0.2")

libraryDependencies += "com.evolutiongaming" %% "stracer"           % "5.0.0"

libraryDependencies += "com.evolutiongaming" %% "stracer-play-json" % "5.0.0"

libraryDependencies += "com.evolutiongaming" %% "stracer-circe"     % "5.0.0"

libraryDependencies += "com.evolutiongaming" %% "stracer-kafka"     % "5.0.0"

```