https://github.com/yurishkuro/opentracing-tutorial

A collection of tutorials for the OpenTracing API
https://github.com/yurishkuro/opentracing-tutorial

Last synced: 9 days ago
JSON representation

A collection of tutorials for the OpenTracing API

• Host: GitHub
• URL: https://github.com/yurishkuro/opentracing-tutorial
• Owner: yurishkuro
• License: apache-2.0
• Archived: true
• Created: 2017-09-24T17:31:15.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2022-12-08T15:14:22.000Z (almost 2 years ago)
• Last Synced: 2024-06-18T12:44:28.333Z (5 months ago)
• Language: Java
• Size: 424 KB
• Stars: 1,565
• Watchers: 49
• Forks: 403
• Open Issues: 28
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# OpenTracing Tutorials

A collection of tutorials for the OpenTracing API (https://opentracing.io).

**Update (Dec 8 2022)**: Since OpenTracing has been officially retired, I have archived this repository. The tutorials here are still useful when learning about distributed tracing, but using the [OpenTelemetry](https://opentelemetry.io/) API should be preferred over the OpenTracing API for new applications.

The blog post ["Migrating from Jaeger client to OpenTelemetry SDK"](https://medium.com/jaegertracing/migrating-from-jaeger-client-to-opentelemetry-sdk-bd337d796759) can also be used as a reference on how to use the OpenTelemetry SDK as an OpenTracing tracer implementation.

## Tutorials by Language

  * [C# tutorial](./csharp/)

  * [Go tutorial](./go/)

  * [Java tutorial](./java)

  * [Python tutorial](./python)

  * [Node.js tutorial](./nodejs)

Also check out examples from the book [Mastering Distributed Tracing](https://www.shkuro.com/books/2019-mastering-distributed-tracing/):

* [Chapter 4: Instrumentation Basics with OpenTracing](https://github.com/PacktPublishing/Mastering-Distributed-Tracing/tree/master/Chapter04)

* [Chapter 5: Instrumentation of Asynchronous Applications](https://github.com/PacktPublishing/Mastering-Distributed-Tracing/tree/master/Chapter05)

* [Chapter 7: Tracing with Service Mesh](https://github.com/PacktPublishing/Mastering-Distributed-Tracing/tree/master/Chapter07)

* [Chapter 11: Integration with Metrics and Logs](https://github.com/PacktPublishing/Mastering-Distributed-Tracing/tree/master/Chapter11)

* [Chapter 12: Gathering Insights Through Data Mining](https://github.com/PacktPublishing/Mastering-Distributed-Tracing/tree/master/Chapter12)

## Prerequisites

The tutorials are using CNCF Jaeger (https://jaegertracing.io) as the tracing backend.

For this tutorial, we'll start Jaeger via Docker with the default in-memory storage, exposing only the required ports. We'll also enable "debug" level logging:

```

docker run \

  --rm \

  -p 6831:6831/udp \

  -p 6832:6832/udp \

  -p 16686:16686 \

  jaegertracing/all-in-one:1.7 \

  --log-level=debug

```

Alternatively, Jaeger can be downloaded as a binary called `all-in-one` for different platforms from https://jaegertracing.io/download/.

Once the backend starts, the Jaeger UI will be accessible at http://localhost:16686.