Azure Monitor OpenTelemetry Exporter for Java Acceptance Criteria

SDK: com.azure:azure-monitor-opentelemetry-exporter (DEPRECATED) Repository: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/monitor/azure-monitor-opentelemetry-exporterPurpose: Skill testing acceptance criteria for validating generated code correctness

---

⚠️ DEPRECATION NOTICE

This package is deprecated. Migrate to azure-monitor-opentelemetry-autoconfigure.

---

1. Recommended: Use Autoconfigure

1.1 ✅ CORRECT: Use Autoconfigure Package

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-monitor-opentelemetry-autoconfigure</artifactId>
    <version>LATEST</version>
</dependency>

1.2 ✅ CORRECT: Setup with Autoconfigure

import io.opentelemetry.sdk.autoconfigure.AutoConfiguredOpenTelemetrySdk;
import io.opentelemetry.sdk.autoconfigure.AutoConfiguredOpenTelemetrySdkBuilder;
import io.opentelemetry.api.OpenTelemetry;
import com.azure.monitor.opentelemetry.exporter.AzureMonitorExporter;

// Connection string from APPLICATIONINSIGHTS_CONNECTION_STRING env var
AutoConfiguredOpenTelemetrySdkBuilder sdkBuilder = AutoConfiguredOpenTelemetrySdk.builder();
AzureMonitorExporter.customize(sdkBuilder);
OpenTelemetry openTelemetry = sdkBuilder.build().getOpenTelemetrySdk();

---

2. Creating Spans

2.1 ✅ CORRECT: Basic Span

import io.opentelemetry.api.trace.Tracer;
import io.opentelemetry.api.trace.Span;
import io.opentelemetry.context.Scope;

Tracer tracer = openTelemetry.getTracer("com.example.myapp");

Span span = tracer.spanBuilder("myOperation").startSpan();

try (Scope scope = span.makeCurrent()) {
    doWork();
} catch (Throwable t) {
    span.recordException(t);
    throw t;
} finally {
    span.end();
}

2.2 ✅ CORRECT: Span with Attributes

Span span = tracer.spanBuilder("processOrder")
    .setAttribute("order.id", "12345")
    .setAttribute("customer.tier", "premium")
    .startSpan();

---

3. Recording Exceptions

3.1 ✅ CORRECT: Record Exception on Span

Span span = tracer.spanBuilder("riskyOperation").startSpan();
try (Scope scope = span.makeCurrent()) {
    performRiskyWork();
} catch (Exception e) {
    span.recordException(e);
    span.setStatus(StatusCode.ERROR, e.getMessage());
    throw e;
} finally {
    span.end();
}

---

4. Best Practices Checklist

• [ ] Use azure-monitor-opentelemetry-autoconfigure instead of this package
• [ ] Set APPLICATIONINSIGHTS_CONNECTION_STRING environment variable
• [ ] Use meaningful span names
• [ ] Add relevant attributes for debugging
• [ ] Always record exceptions on spans
• [ ] End spans in finally block
• [ ] Use try-with-resources for Scope management