Add GenAI exception event extractor helper

Author: trask

instrumentation-api-incubator/src/main/java/io/opentelemetry/instrumentation/api/incubator/semconv/genai/internal/GenAiExceptionEventExtractors.java

@@ -0,0 +1,38 @@
+/*
+ * Copyright The OpenTelemetry Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+package io.opentelemetry.instrumentation.api.incubator.semconv.genai.internal;
+
+import com.google.errorprone.annotations.CanIgnoreReturnValue;
+import io.opentelemetry.api.logs.Severity;
+import io.opentelemetry.instrumentation.api.instrumenter.InstrumenterBuilder;
+import io.opentelemetry.instrumentation.api.internal.Experimental;
+
+/**
+ * This class is internal and is hence not for public use. Its APIs are unstable and can change at
+ * any time.
+ */
+public final class GenAiExceptionEventExtractors {
+
+  /**
+   * Configures the GenAI client operation exception event name and severity. Only takes effect when
+   * emitting exceptions as logs is enabled via the {@code otel.semconv.exception.signal.preview}
+   * flag.
+   */
+  @CanIgnoreReturnValue
+  public static <REQUEST, RESPONSE>
+      InstrumenterBuilder<REQUEST, RESPONSE> setGenAiClientExceptionEventExtractor(
+          InstrumenterBuilder<REQUEST, RESPONSE> builder) {
+    Experimental.setExceptionEventExtractor(
+        builder,
+        (logRecordBuilder, context, request) -> {
+          logRecordBuilder.setEventName("gen_ai.client.operation.exception");
+          logRecordBuilder.setSeverity(Severity.WARN);
+        });
+    return builder;
+  }
+
+  private GenAiExceptionEventExtractors() {}
+}

instrumentation/openai/openai-java-1.1/library/src/main/java/io/opentelemetry/instrumentation/openai/v1_1/OpenAITelemetryBuilder.java

@@ -5,6 +5,8 @@
 
 package io.opentelemetry.instrumentation.openai.v1_1;
 
+import static io.opentelemetry.instrumentation.api.incubator.semconv.genai.internal.GenAiExceptionEventExtractors.setGenAiClientExceptionEventExtractor;
+
 import com.google.errorprone.annotations.CanIgnoreReturnValue;
 import com.openai.models.chat.completions.ChatCompletion;
 import com.openai.models.chat.completions.ChatCompletionCreateParams;
@@ -49,22 +51,25 @@ public OpenAITelemetryBuilder setCaptureMessageContent(boolean captureMessageCon
   public OpenAITelemetry build() {
     ChatAttributesGetter chatAttributesGetter = new ChatAttributesGetter();
     Instrumenter<ChatCompletionCreateParams, ChatCompletion> chatInstrumenter =
-        Instrumenter.<ChatCompletionCreateParams, ChatCompletion>builder(
-                openTelemetry,
-                INSTRUMENTATION_NAME,
-                GenAiSpanNameExtractor.create(chatAttributesGetter))
-            .addAttributesExtractor(GenAiAttributesExtractor.create(chatAttributesGetter))
-            .addOperationMetrics(GenAiClientMetrics.get())
+        setGenAiClientExceptionEventExtractor(
+                Instrumenter.<ChatCompletionCreateParams, ChatCompletion>builder(
+                        openTelemetry,
+                        INSTRUMENTATION_NAME,
+                        GenAiSpanNameExtractor.create(chatAttributesGetter))
+                    .addAttributesExtractor(GenAiAttributesExtractor.create(chatAttributesGetter))
+                    .addOperationMetrics(GenAiClientMetrics.get()))
             .buildInstrumenter();
 
     EmbeddingAttributesGetter embeddingAttributesGetter = new EmbeddingAttributesGetter();
     Instrumenter<EmbeddingCreateParams, CreateEmbeddingResponse> embeddingsInstrumenter =
-        Instrumenter.<EmbeddingCreateParams, CreateEmbeddingResponse>builder(
-                openTelemetry,
-                INSTRUMENTATION_NAME,
-                GenAiSpanNameExtractor.create(embeddingAttributesGetter))
-            .addAttributesExtractor(GenAiAttributesExtractor.create(embeddingAttributesGetter))
-            .addOperationMetrics(GenAiClientMetrics.get())
+        setGenAiClientExceptionEventExtractor(
+                Instrumenter.<EmbeddingCreateParams, CreateEmbeddingResponse>builder(
+                        openTelemetry,
+                        INSTRUMENTATION_NAME,
+                        GenAiSpanNameExtractor.create(embeddingAttributesGetter))
+                    .addAttributesExtractor(
+                        GenAiAttributesExtractor.create(embeddingAttributesGetter))
+                    .addOperationMetrics(GenAiClientMetrics.get()))
             .buildInstrumenter(SpanKindExtractor.alwaysClient());
 
     Logger eventLogger = openTelemetry.getLogsBridge().get(INSTRUMENTATION_NAME);