R/tracer-provider-stdout.R

In otelsdk: 'R' 'SDK' and Exporters for 'OpenTelemetry'

tracer_provider_stdstream_new <- function(opts = NULL) {
  opts <- as_tracer_provider_stdstream_options(opts)
  self <- new_object(
    c("otel_tracer_provider_stdstream", "otel_tracer_provider"),
    get_tracer = function(
      name = NULL,
      version = NULL,
      schema_url = NULL,
      attributes = NULL,
      ...
    ) {
      tracer_new(self, name, version, schema_url, attributes, ...)
    },
    flush = function() {
      ccall(otel_tracer_provider_flush, self$xptr)
    }
  )
  attributes <- as_otel_attributes(the$default_resource_attributes)
  self$xptr <- ccall(otel_create_tracer_provider_stdstream, opts, attributes)
  self
}

tracer_provider_stdstream_options <- function() {
  as_tracer_provider_stdstream_options(NULL)
}

#' Tracer provider to write to the standard output or standard error or
#' to a file
#'
#' @description
#' Writes spans to the standard output or error, or to a file. Useful for
#' debugging.
#'
#' # Usage
#'
#' Externally:
#' ```
#' OTEL_TRACES_EXPORTER=console
#' OTEL_TRACES_EXPORTER=stderr
#' ```
#'
#' From R:
#' ```
#' tracer_provider_stdstream$new(opts = NULL)
#' tracer_provider_stdstream$options()
#' ```
#'
#' # Arguments
#'
#' `opts`: Named list of options. See below.
#'
#' # Options
#'
#' ## Standard stream exporter options
#'
#' ```{r}
#' #| echo: FALSE
#' #| results: asis
#' cat(doc_stdstream_exporter_options(
#'   tracer_provider_stdstream_options_evs()
#' ))
#' ```
#'
#' @return
#' `tracer_provider_stdstream$new()` returns an [otel::otel_tracer_provider]
#' object.
#'
#' `tracer_provider_stdstream$options()` returns a named list, the current
#' values of the options.
#'
#' @format NULL
#' @usage NULL
#' @export
#' @examples
#' tracer_provider_stdstream$options()

tracer_provider_stdstream <- list(
  new = tracer_provider_stdstream_new,
  options = tracer_provider_stdstream_options
)