newrelic-telemetry-sdk.h

Go to the documentation of this file.

/*
 * Copyright 2020 New Relic Corporation. All rights reserved.
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef NEWRELIC_TELEMETRY_SDK
#define NEWRELIC_TELEMETRY_SDK
 
#include <stdbool.h>
#include <stdint.h>
#include <stddef.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef struct _nrt_client_config_t nrt_client_config_t;
 
typedef struct _nrt_client_t nrt_client_t;
 
typedef struct _nrt_span_batch_t nrt_span_batch_t;
 
typedef struct _nrt_span_t nrt_span_t;
 
typedef struct _nrt_attributes_t nrt_attributes_t;
 
typedef uint64_t nrt_time_t;
 
nrt_attributes_t* nrt_attributes_new();
 
typedef enum {
  NRT_LOG_ERROR = 0,
  NRT_LOG_WARN = 1,
  NRT_LOG_INFO = 2,
  NRT_LOG_DEBUG = 3,
  NRT_LOG_TRACE = 4,
} nrt_log_level_t;
 
bool nrt_log_init(nrt_log_level_t level, const char* filename);
 
bool nrt_attributes_set_int(nrt_attributes_t* attributes,
                            const char* key,
                            int64_t value);
 
bool nrt_attributes_set_uint(nrt_attributes_t* attributes,
                             const char* key,
                             uint64_t value);
 
bool nrt_attributes_set_double(nrt_attributes_t* attributes,
                               const char* key,
                               double value);
 
bool nrt_attributes_set_string(nrt_attributes_t* attributes,
                               const char* key,
                               const char* value);
 
bool nrt_attributes_set_bool(nrt_attributes_t* attributes,
                             const char* key,
                             bool value);
 
void nrt_attributes_destroy(nrt_attributes_t** attributes);
 
nrt_span_t* nrt_span_new(const char* id,
                         const char* trace_id,
                         uint64_t timestamp);
 
bool nrt_span_set_id(nrt_span_t* span, const char* id);
 
bool nrt_span_set_trace_id(nrt_span_t* span, const char* trace_id);
 
bool nrt_span_set_timestamp(nrt_span_t* span, nrt_time_t timestamp);
 
bool nrt_span_set_name(nrt_span_t* span, const char* name);
 
bool nrt_span_set_service_name(nrt_span_t* span, const char* service_name);
 
bool nrt_span_set_parent_id(nrt_span_t* span, const char* parent_id);
 
bool nrt_span_set_duration(nrt_span_t* span, nrt_time_t duration);
 
bool nrt_span_set_attributes(nrt_span_t* span, nrt_attributes_t** attributes);
 
void nrt_span_destroy(nrt_span_t** span);
 
nrt_span_batch_t* nrt_span_batch_new();
 
bool nrt_span_batch_record(nrt_span_batch_t* batch, nrt_span_t** span);
 
void nrt_span_batch_destroy(nrt_span_batch_t** batch);
 
nrt_client_config_t* nrt_client_config_new(const char* key);
 
void nrt_client_config_set_backoff_factor(nrt_client_config_t* config,
                                          nrt_time_t backoff_factor);
 
void nrt_client_config_set_retries_max(nrt_client_config_t* config,
                                       uint32_t retries);
 
void nrt_client_config_set_endpoint_traces(nrt_client_config_t* config,
                                           const char* host,
                                           uint16_t port);
 
void nrt_client_config_set_product_info(nrt_client_config_t* config,
                                        const char* product,
                                        const char* version);
 
void nrt_client_config_set_queue_max(nrt_client_config_t* config,
                                     size_t queue_max);
 
void nrt_client_config_destroy(nrt_client_config_t** config);
 
nrt_client_t* nrt_client_new(nrt_client_config_t** config);
 
bool nrt_client_send(nrt_client_t* client, nrt_span_batch_t** batch);
 
void nrt_client_shutdown(nrt_client_t** client);
 
void nrt_client_destroy(nrt_client_t** client);
 
#ifdef __cplusplus
}
#endif
 
#endif /* NEWRELIC_TELEMETRY_SDK */