fix: de-dot gRPC message.* spanevent attrs to prevent GenAI event mapping conflict\n\n- Add spanevent transform rules in otel-collector to rename message.type,\n message.id, message.uncompressed_size to message_type, message_id,\n message_uncompressed_size. This prevents OpenSearch mapping conflicts\n between gRPC message events (object) and GenAI events (string).\n- Enable OTEL_SEMCONV_STABILITY_OPT_IN=gen_ai_latest_experimental in\n Strands code-assistant example for structured gen_ai.input.messages\n and gen_ai.output.messages on trace events. (opensearch-project#90)

Author: kylehounslow

docker-compose/otel-collector/config.yaml

@@ -62,6 +62,19 @@ processors:
           - delete_key(attributes, "app.ads.contextKeys")
           - set(attributes["rpc_system"], attributes["rpc.system"]) where attributes["rpc.system"] != nil
           - delete_key(attributes, "rpc.system")
+      - context: spanevent
+        statements:
+          # De-dot gRPC message.* event attributes to prevent mapping conflict with
+          # GenAI event attributes where "message" is a plain string value.
+          # Without this, flagd's message.type/message.id/message.uncompressed_size
+          # create an object mapping for events.attributes.message, which conflicts
+          # with GenAI spans that use events.attributes.message as a string.
+          - set(attributes["message_type"], attributes["message.type"]) where attributes["message.type"] != nil
+          - delete_key(attributes, "message.type")
+          - set(attributes["message_id"], attributes["message.id"]) where attributes["message.id"] != nil
+          - delete_key(attributes, "message.id")
+          - set(attributes["message_uncompressed_size"], attributes["message.uncompressed_size"]) where attributes["message.uncompressed_size"] != nil
+          - delete_key(attributes, "message.uncompressed_size")
     log_statements:
       - context: log
         statements:

examples/strands/code-assistant/main.py

@@ -33,6 +33,12 @@
 # This provides better visibility into tool calls during development
 os.environ["STRANDS_TOOL_CONSOLE_MODE"] = "enabled"
 
+# Opt-in to latest GenAI semantic conventions (v1.37+) for richer trace data:
+# - gen_ai.input.messages / gen_ai.output.messages on events (structured I/O)
+# - gen_ai.provider.name instead of gen_ai.system
+# Also include tool definitions in traces for eval-ready spans.
+os.environ["OTEL_SEMCONV_STABILITY_OPT_IN"] = "gen_ai_latest_experimental,gen_ai_tool_definitions"
+
 # ============================================================================
 # OPENTELEMETRY SETUP - OTLP EXPORTER CONFIGURATION
 # ============================================================================