feat: integrate Otel tests

[chenhuansome]

What problem does this PR solve?

This PR implements OpenTelemetry distributed tracing functionality within the OpenGemini Java client. Through an interceptor mechanism, it automatically adds trace spans for all database operations (queries, writes, etc.) and exports the trace data to Jaeger for visualization and analysis.

Main Changes

1. New Tracing Interceptor Implementation

• Created the OtelInterceptor class to handle OpenTelemetry trace propagation
• Creates spans for each database operation and records relevant attributes
• Supports context propagation for asynchronous operations

2. New Integration Test Class

• TracingIntegrationTest: Comprehensive end-to-end integration tests
• Tests scenarios including database creation, query operations, write operations
• Verifies that trace data is correctly generated and exported

3. CI/CD Integration

• Automatically starts the ts-trace service in GitHub Actions
• Ensures integration tests run correctly in the CI environment

4. Configuration Management

• Supports enabling/disabling tracing functionality via configuration
• Configurable Jaeger export endpoint and other OpenTelemetry parameters

Technical Features

• Non-intrusive Integration: Uses the interceptor pattern; business code gains tracing capability without modifications
• Async Support: Full support for the client's asynchronous operation mode
• Error Handling: Includes fallback mechanism; automatically reverts to no-op implementation if tracing components are unavailable
• ·Performance Optimization: Uses batch span processing to minimize impact on business performance

Test Verification

• [✓ ] Trace for database creation operations

• [✓ ] Trace for query operations

• [✓ ] Trace for write operations

• [✓ ] End-to-end integration process tracing

• [✓ ] Exception handling

Architecture Diagram:

OpenGemini Client → OtelInterceptor → BatchSpanProcessor → JaegerExporter → Jaeger UI

Usage

// Create configuration
Configuration config = Configuration.builder()
    .addresses(Collections.singletonList(new Address("127.0.0.1", 8086)))
    .build();

// Create client and add tracing interceptor
OpenGeminiClient client = new OpenGeminiClient(config);
OtelInterceptor otelInterceptor = new OtelInterceptor();
otelInterceptor.setTracer(getTracer());
client.addInterceptors(otelInterceptor);

// All subsequent operations will be automatically traced
client.query(new Query("SHOW DATABASES"));

*related documents：
openGemini/openGemini.github.io#163

[dosubot]

Documentation Updates

Checked 2 published document(s). No updates required.

^{How did I do? Any feedback?}