Disable internal otel logging

[Falmarri]

Is it possible to disable the otel error logs? Specifically, the log messages such as

[Error] File: /opentelemetry-cpp/exporters/otlp/src/otlp_http_exporter.cc:106 [OTLP HTTP Client] ERROR: Export 357 trace span(s) error: 1

I can't seem to find any settings to set the log level of these or turn them off

[lalitb]

You can add a custom log-handler, with custom processing that could be to ignore the error logs -

opentelemetry-cpp/sdk/include/opentelemetry/sdk/common/global_log_handler.h

Line 107 in 611caa7

static inline void SetLogHandler(nostd::shared_ptr<LogHandler> eh) noexcept

Though recommendation would be to fix the error :)

[Falmarri]

The error happens when our collector is overloaded. Not much I can do about that, and it's not something clients can do anything about or should even know.

And just dumping data to stdout from a library seems very problematic. A tracing library should NEVER impact functionality of an application no matter what, even if it's not able to export spans. Dumping random stuff to stdout is very likely to cause actual problems. At the very least it should go to stderr by default, but even then, having a library write logs without explicit configuration seems very questionable to me.

[marcalff]

For an application using opentelemetry-cpp, we (speaking for the app, not as a maintainer) decided to implement a custom handler, and implement an extra log level setting : SILENT, by printing nothing in the custom log handler.

Having a SILENT log level supported in opentelemetry-cpp natively would help and make things simpler.

The motivation for silencing errors entirely is in particular during tests, because errors printed from opentelemetry-cpp in stdout affect the test output, causing functional tests of the app to fail even when the app is working normally.

Whether using a SILENT log level in production is desirable or not is up to the application, but at least I think (now speaking as a maintainer) that opentelemetry-cpp should support log level SILENT.

For robustness reasons, assuming one day we discover a crashing bug in an error code path (say, crashing while printing more data in the error log), having the possibility to disable this crashing code path would also allow the application to survive in a degraded mode, at least as a work around: defense in depth.

[Falmarri]

Can I suggest making silent the default? Like you said, content on stdout is bad for tests, but it's even worse for actual production code. Not everything using tracing is a daemon that just logs to stdout. My app has a small portion that can be used as part of a unix pipeline doing ETL work and having random stuff on stdout is not something I can even remotely deal with.

[marcalff]

The spec does not even enumerate possible values for OTEL_LOG_LEVEL, and implementation varies per language:

• Standardize SDK logging levels opentelemetry-specification#2039
• Clarify values for OTEL_LOG_LEVEL opentelemetry-specification#920
• Add support for OTEL_LOG_LEVEL env variable opentelemetry-python#1059
• Add OTEL_LOG_LEVEL support opentelemetry-dotnet-instrumentation#372

I think we can have a LogLevel::None, at least it will be consistent with .NET.

Note that opentelemetry-cpp does not support OTEL_LOG_LEVEL either, this probably should be fixed.

[marcalff]

At the very least it should go to stderr by default.

Indeed, having the default log handler print to std::cout is a poor choice.

[lalitb]

Indeed, having the default log handler print to std::cout is a poor choice.

Yes, it was me, probably writing this while feeling 😪 .
The options as of now are:

• use custom log handler. And don't rely on DefaultLogHandler for production usage.
• Rebuild otel-cpp sdk with macro OTEL_INTERNAL_LOG_LEVEL as -1 or anything less than 0.
• redirect application stdout to /dev/null.

[marcalff]

I think it is safe to:

• Change the DefaultLogHandler to use stderr instead, and document this as a SDK important change. I would be surprised if anyone considers this breaking, real applications most likely use their own handler anyway.
• Re number log levels starting with None=0, Error=1, etc, and also document this as an important change. This changes the SDK ABI in case someone links dynamically with the SDK, which we do not support anyway.

@lalitb If this sounds good, I can make a PR for it.

[lalitb]

Yes, I think we should fix the code. Don't think it is feasible to do it withot breaking SDK ABI. Thanks :)