Add Oracle UCP telemetry

[abrenk]

This commit adds a new module to integrate with the OpenTelemetry Library Instrumentation for Oracle UCP.

[abrenk]

Does it make sense to also implement BeanDestroyedEventListener or BeanPreDestroyEventListener?

@Override
public void onDestroyed(@NonNull BeanDestroyedEvent<UniversalConnectionPool> event) {
    final UniversalConnectionPool connectionPool = event.getBean();
    
    oracleUcpTelemetryConfiguration.oracleUcpTelemetry.unregisterMetrics(connectionPool);
}

or

@Override
public @NonNull UniversalConnectionPool onPreDestroy(@NonNull BeanPreDestroyEvent<UniversalConnectionPool> event) {
    final UniversalConnectionPool connectionPool = event.getBean();
    oracleUcpTelemetryConfiguration.oracleUcpTelemetry.unregisterMetrics(connectionPool);

    return connectionPool;
}

[abrenk]

What needs to be done to fix the build error?

Execution failed for task ':micronaut-tracing-opentelemetry-ucp:findBaseline'.
> Could not find a previous version for 7.2.1

[radovanradic]

There are checkstyle errors

[radovanradic]

Does it make sense to also implement BeanDestroyedEventListener or BeanPreDestroyEventListener?

@Override
public void onDestroyed(@NonNull BeanDestroyedEvent<UniversalConnectionPool> event) {
    final UniversalConnectionPool connectionPool = event.getBean();
    
    oracleUcpTelemetryConfiguration.oracleUcpTelemetry.unregisterMetrics(connectionPool);
}

or

@Override
public @NonNull UniversalConnectionPool onPreDestroy(@NonNull BeanPreDestroyEvent<UniversalConnectionPool> event) {
    final UniversalConnectionPool connectionPool = event.getBean();
    oracleUcpTelemetryConfiguration.oracleUcpTelemetry.unregisterMetrics(connectionPool);

    return connectionPool;
}

Makes sense, I think BeanDestroyedEvent can be used

[radovanradic]

Can test be added, maybe similar to JdbcTelemetrySpanSpec

[n0tl3ss]

docs is missing from the src/main/docs/guide

[abrenk]

Thanks for the reviews. I've done the following changes:

• Set binaryCompatibility to '7.2.2'.
• Implemented BeanDestroyedEventListener and therefore renamed the Listener class to UniversalConnectionPoolBeanEventListener.
• Fixed the line endings Checkstyle was complaining about.
• Written a new chapter for the guide.
• Removed @ConfigurationBuilder(prefixes = "set")

Regarding an extended test case I'm not sure how to implement it without a running Oracle Database. Or should I try to use the Testcontainers Oracle-XE Module?

[n0tl3ss]

Oracle-XE Module?

Try to use https://micronaut-projects.github.io/micronaut-test-resources/latest/guide/. The test dependency is:
https://mvnrepository.com/artifact/io.micronaut.testresources/micronaut-test-resources-jdbc-oracle-xe

[radovanradic]

That is UCP, does not need to be Oracle connection. You can test it with H2 I guess.