tracer.h

Go to the documentation of this file.

#ifndef OPENTRACINGC_TRACER_H
#define OPENTRACINGC_TRACER_H

#include <opentracing-c/config.h>
#include <opentracing-c/propagation.h>
#include <opentracing-c/span.h>
#include <opentracing-c/visibility.h>

#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */

typedef struct opentracing_tag {
    char* key;
    opentracing_value value;
} opentracing_tag;

typedef struct opentracing_start_span_options {
    opentracing_duration start_time_steady;

    opentracing_timestamp start_time_system;

    const opentracing_span_reference* references;

    int num_references;

    const opentracing_tag* tags;

    int num_tags;
} opentracing_start_span_options;

typedef struct opentracing_tracer {
    opentracing_destructible base;

    void (*close)(struct opentracing_tracer* tracer) OPENTRACINGC_NONNULL_ALL;

    opentracing_span* (*start_span)(struct opentracing_tracer* tracer,
                                    const char* operation_name)
        OPENTRACINGC_NONNULL_ALL;

    opentracing_span* (*start_span_with_options)(
        struct opentracing_tracer* tracer,
        const char* operation_name,
        const opentracing_start_span_options* options) OPENTRACINGC_NONNULL(1,
                                                                            2);

    opentracing_propagation_error_code (*inject_text_map)(
        struct opentracing_tracer* tracer,
        opentracing_text_map_writer* carrier,
        const opentracing_span_context* span_context) OPENTRACINGC_NONNULL_ALL;

    opentracing_propagation_error_code (*inject_http_headers)(
        struct opentracing_tracer* tracer,
        opentracing_http_headers_writer* carrier,
        const opentracing_span_context* span_context) OPENTRACINGC_NONNULL_ALL;

    opentracing_propagation_error_code (*inject_binary)(
        struct opentracing_tracer* tracer,
        int (*callback)(void*, const char*, size_t),
        void* arg,
        const opentracing_span_context* span_context)
        OPENTRACINGC_NONNULL(1, 2, 4);

    opentracing_propagation_error_code (*inject_custom)(
        struct opentracing_tracer* tracer,
        opentracing_custom_carrier_writer* carrier,
        const opentracing_span_context* span_context) OPENTRACINGC_NONNULL_ALL;

    opentracing_propagation_error_code (*extract_text_map)(
        struct opentracing_tracer* tracer,
        opentracing_text_map_reader* carrier,
        opentracing_span_context** span_context) OPENTRACINGC_NONNULL_ALL;

    opentracing_propagation_error_code (*extract_http_headers)(
        struct opentracing_tracer* tracer,
        opentracing_http_headers_reader* carrier,
        opentracing_span_context** span_context) OPENTRACINGC_NONNULL_ALL;

    opentracing_propagation_error_code (*extract_binary)(
        struct opentracing_tracer* tracer,
        int (*callback)(void*, char*, size_t),
        void* arg,
        opentracing_span_context** span_context) OPENTRACINGC_NONNULL(1, 2, 4);

    opentracing_propagation_error_code (*extract_custom)(
        struct opentracing_tracer* tracer,
        opentracing_custom_carrier_reader* carrier,
        opentracing_span_context** span_context) OPENTRACINGC_NONNULL_ALL;
} opentracing_tracer;

OPENTRACINGC_EXPORT opentracing_tracer* opentracing_global_tracer(void);

OPENTRACINGC_EXPORT void opentracing_init_global_tracer(
    opentracing_tracer* tracer) OPENTRACINGC_NONNULL_ALL;

#ifdef __cplusplus
}
#endif /* __cplusplus */

#endif /* OPENTRACINGC_TRACER_H */