feat(core)!: implement an interceptor for the logging layer

[evenyag]

Which issue does this PR close?

Closes #4918.

Rationale for this change

What changes are included in this PR?

Are there any user-facing changes?

Breaking changes: This PR removes with_error_level(), with_failure_level() and with_backtrace_output() from the DefaultLoggingLayer.

It adds a new trait LoggingInterceptor to log messages.

pub trait LoggingInterceptor: Debug + Send + Sync + 'static {
    fn log(
        &self,
        scheme: Scheme,
        operation: Operation,
        path: &str,
        context: &str,
        message: &str,
        err: Option<&Error>,
    );
}

The LoggingLayer has a new method to construct a new layer from an interceptor.

fn new<I: LoggingInterceptor>(notify: I) -> LoggingLayer<I> {}

[Xuanwo]

Thanks a lot for this PR!

[Xuanwo]

After this refactor, the LoggingLayer is no longer limited to just log. Users can now employ tracing or any other logging libraries they prefer. We could potentially offer enhanced support for these use cases by providing default tracing/log support.

It's not part of this PR, we can discuss them later.

[Xuanwo]

Hi, I plan to include this PR in our upcoming 0.49.0 release. However, if you are currently busy, we can also postpone it to the next release. Which do you prefer?

[evenyag]

Okay, I'll address the comments in these two days.

[Xuanwo]

Okay, I'll address the comments in these two days.

Thanks a lot!

[Xuanwo]

Others look great to me, thanks!

[Xuanwo]

Thanks a lot, mostly LGTM! We only need to get CI happy.

• the haskell test doesn't make sense, we can remove the testLogger part

https://github.com/apache/opendal/blob/690e49467228602cccabe78ba8403fd9123146d4/bindings/haskell/test/BasicTest.hs#L35C29-L35C39

• The unit test of core failed. Please note we can't use crate in doc test, we should use opendal::Error.

[Xuanwo]

Thanks a lot!