otel_logger_provider -> otel_logger
Not applicable.
logger$is_enabled()
Whether the logger is active and emitting logs at a certain severity level.
This is equivalent to the is_logging_enabled() function.
logger$is_enabled(severity = "info", event_id = NULL)
severity: Check if logs are emitted at this severity level.
event_id: Not implemented yet.
Logical scalar.
logger$get_minimum_severity()
Get the current minimum severity at which the logger is emitting logs.
logger_get_minimum_severity()
Named integer scalar.
logger$set_minimum_severiry()
Set the minimum severity for emitting logs.
logger$set_minimum_severity(minimum_severity)
minimum_severity: Log severity, a string, one of
"trace", "trace2", "trace3", "trace4", "debug", "debug2", "debug3", "debug4", "info", "info2", "info3", "info4", "warn", "warn2", "warn3", "warn4", "error", "error2", "error3", "error4", "fatal", "fatal2", "fatal3", "fatal4".
Nothing.
logger$log()
Log an OpenTelemetry log message.
logger$log(
msg = "",
severity = "info",
span_context = NULL,
span_id = NULL,
trace_id = NULL,
trace_flags = NULL,
timestamp = SYs.time(),
observed_timestamp = NULL,
attributes = NULL,
.envir = parent.frame()
)
msg: Log message, may contain R expressions to evaluate within
braces.
severity: Log severity, a string, one of
"trace", "trace2", "trace3", "trace4", "debug", "debug2", "debug3", "debug4", "info", "info2", "info3", "info4", "warn", "warn2", "warn3", "warn4", "error", "error2", "error3", "error4", "fatal", "fatal2", "fatal3", "fatal4".
span_context: An otel_span_context object to associate the log
message with a span.
span_id: Alternatively to span_context, you can also specify
span_id, trace_id and trace_flags to associate a log message
with a span.
trace_id: Alternatively to span_context, you can also specify
span_id, trace_id and trace_flags to associate a log message
with a span.
trace_flags: Alternatively to span_context, you can also specify
span_id, trace_id and trace_flags to associate a log message
with a span.
timestamp: Time stamp, defaults to the current time. This is the
time the logged event occurred.
observed_timestamp: Observed time stamp, this is the time the
event was observed.
attributes: Optional attributes, see as_attributes() for the
possible values.
The logger object, invisibly.
logger$trace()
The same as logger$log(), with severity = "trace".
logger$debug()
The same as logger$log(), with severity = "debug".
logger$info()
The same as logger$log(), with severity = "info".
logger$warn()
The same as logger$log(), with severity = "warn".
logger$error()
The same as logger$log(), with severity = "error".
logger$fatal()
The same as logger$log(), with severity = "fatal".
Usually you do not need to deal with otel_logger objects directly.
log() automatically sets up the logger for emitting the logs.
A logger object is created by calling the get_logger() method of an
otel_logger_provider.
You can use the log() method of the logger object to emit logs.
Typically there is a separate logger object for each instrumented R package.
Other low level logs API:
get_default_logger_provider(),
get_logger(),
logger_provider_noop,
otel_logger_provider
lp <- get_default_logger_provider()
lgr <- lp$get_logger()
platform <- utils::sessionInfo()$platform
lgr$log("This is a log message from {platform}.", severity = "trace")
Run the code above in your browser using DataLab