implement details event and add tests

Author: lmolkova

instrumentation-genai/opentelemetry-instrumentation-openai-v2/README.rst

@@ -82,6 +82,8 @@ Message content such as the contents of the prompt, completion, function argumen
 are not captured by default. To capture message content as log events, set the environment variable
 `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT` to `true`.
 
+TODO!
+
 Uninstrument
 ************
 

instrumentation-genai/opentelemetry-instrumentation-openai-v2/examples/manual/.env

@@ -12,5 +12,19 @@ OPENAI_API_KEY=sk-YOUR_API_KEY
 
 OTEL_SERVICE_NAME=opentelemetry-python-openai
 
-# Change to 'false' to hide prompt and completion content
-OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true
+# Remove or change to 'none' to hide prompt and completion content
+# Possible values (case insensitive):
+# - `span` - record content on span attibutes
+# - `event` - record content on event attributes
+# - `true` - only used for backward compatibility when 
+#            `gen_ai_latest_experimental` is not set in the 
+#            `OTEL_SEMCONV_STABILITY_OPT_IN` environemnt variable.
+# - everything else - don't record content on any signal
+OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=span
+
+# Enables latest and greatest features available in GenAI semantic conventions.
+# Note: since conventions are still in development, using this flag would
+# likely result in having breaking changes. 
+#
+# Comment out if you want to use semantic conventions of version 1.36.0.
+OTEL_SEMCONV_STABILITY_OPT_IN=gen_ai_latest_experimental

instrumentation-genai/opentelemetry-instrumentation-openai-v2/examples/zero-code/.env

@@ -18,5 +18,19 @@ OTEL_PYTHON_LOGGING_AUTO_INSTRUMENTATION_ENABLED=true
 # Uncomment if your OTLP endpoint doesn't support logs
 # OTEL_LOGS_EXPORTER=console
 
-# Change to 'false' to hide prompt and completion content
-OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true
+# Remove or change to 'none' to hide prompt and completion content
+# Possible values (case insensitive):
+# - `span` - record content on span attibutes
+# - `event` - record content on event attributes
+# - `true` - only used for backward compatibility when
+#            `gen_ai_latest_experimental` is not set in the
+#            `OTEL_SEMCONV_STABILITY_OPT_IN` environemnt variable.
+# - everything else - don't record content on any signal
+OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=span
+
+# Enables latest and greatest features available in GenAI semantic conventions.
+# Note: since conventions are still in development, using this flag would
+# likely result in having breaking changes.
+#
+# Comment out if you want to use semantic conventions of version 1.36.0.
+OTEL_SEMCONV_STABILITY_OPT_IN=gen_ai_latest_experimental

instrumentation-genai/opentelemetry-instrumentation-openai-v2/examples/zero-code/README.rst

@@ -16,6 +16,7 @@ Note: `.env <.env>`_ file configures additional environment variables:
 - ``OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true`` configures OpenAI instrumentation to capture prompt and completion contents on events.
 - ``OTEL_LOGS_EXPORTER=otlp`` to specify exporter type.
 
+TODO!
 Setup
 -----