Git Product home page Git Product logo

rustracing's Introduction

rustracing

Crates.io: rustracing Documentation Actions Status Coverage Status License: MIT

OpenTracing API for Rust.

Documentation

Examples

use rustracing::sampler::AllSampler;
use rustracing::tag::Tag;
use rustracing::Tracer;
use std::thread;
use std::time::Duration;

// Creates a tracer
let (span_tx, span_rx) = crossbeam_channel::bounded(10);
let tracer = Tracer::with_sender(AllSampler, span_tx);
{
    // Starts "parent" span
    let parent_span = tracer.span("parent").start_with_state(());
    thread::sleep(Duration::from_millis(10));
    {
        // Starts "child" span
        let mut child_span = tracer
            .span("child_span")
            .child_of(&parent_span)
            .tag(Tag::new("key", "value"))
            .start_with_state(());

        child_span.log(|log| {
            log.error().message("a log message");
        });
    } // The "child" span dropped and will be sent to `span_rx`
} // The "parent" span dropped and will be sent to `span_rx`

// Outputs finished spans to the standard output
while let Ok(span) = span_rx.try_recv() {
    println!("# SPAN: {:?}", span);
}

As an actual usage example of the crate and an implementation of the OpenTracing API, it may be helpful to looking at rustracing_jaeger crate.

References

rustracing's People

Contributors

adamchalmers avatar bobrik avatar jayvdb avatar kornelski avatar mcarton avatar mixalturek avatar sile avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

rustracing's Issues

how to use this

Could you please include a quickstart section to the README with code samples describing the basic usage of this library.

Sharing a Span between threads

I have a web service which uses rayon to compute do multiple operations in parallel. I'd like the work done by each operation to be tracked by a child span of the span showing the whole web request, as the operations are all related.

Currently, Span is !Sync and does not implement Clone, so there doesn't seem to be a way for the different threads to reference the same parent span.

Is there a reason Clone isn't implemented for Span? It might also be worth investigating crossbeam::channel, which I think would allow the Span to be Sync.

Sampled bit from Jaeger is not respected

I'm extracting parent context from an incoming request and can see that SpanContextState from rustracing_jaeger crate has is_sampled() = true. However, the span that I start with the context containing this state does not carry this piece of information.

It looks like span context is not take into account when rustracing decides on whether to sample request or not. I think it should respect downstream decision.

No documentation on how to extract parent from HTTP request headers

A common use case from tracing is to follow requests across multiple applications by adding relevant information about the trace to the HTTP headers in the request. How do I extract those headers with this library (specifically, I'm using hyper) and create a child span across application boundaries?

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.