fix(openai-agents): apply content tracing flag to content

Author: duanyutong

.gitignore

@@ -33,6 +33,7 @@ npm-debug.log
 yarn-error.log
 testem.log
 /typings
+.tool-versions
 
 # System Files
 .DS_Store

CONTRIBUTING.md

@@ -4,3 +4,35 @@ Thanks for taking the time to contribute! 😃 🚀
 
 Please refer to our [Contributing Guide](https://traceloop.com/docs/openllmetry/contributing/overview) for instructions on how to contribute.
 
+## Local Testing and Linting in this Repo
+
+A few steps to set up this repo locally.
+
+Run the following at repo root to setup the yarn dependencies.
+```shell
+npm ci
+```
+
+Install `poetry` (version 2) at the system-level (e.g. using `pipx` or `brew`).
+
+For setting up and testing an individual package, run the following from repo root.
+
+```shell
+npx nx run opentelemetry-instrumentation-openai:install --with dev,test
+npx nx run opentelemetry-instrumentation-openai:lint
+npx nx run opentelemetry-instrumentation-openai:test
+```
+
+Or you can run the following to automatically setup all affected packages.
+```shell
+npx nx affected -t install --with dev,test
+npx nx affected -t lint
+npx nx affected -t test
+```
+
+## Build Errors
+
+If encountering local build errors in environment setup, try a lower python version, e.g. 3.11.
+There are `.python-version` files in individual package directories, but poetry may not reliably respect it.
+Depending on your python installation, you may need to set your python version accordingly at repo root (e.g. with a `.python-version` or `.tool-versions`).
+The `.venv` dir within each package must be deleted before you retry the poetry/nx command, as it will not clear the existing venv and pick up the updated, lower version specified until the existing venv has been deleted manually.

packages/opentelemetry-instrumentation-openai-agents/opentelemetry/instrumentation/openai_agents/_hooks.py

@@ -1,6 +1,6 @@
 """Hook-based instrumentation for OpenAI Agents using the SDK's native callback system."""
 
-from typing import Dict, Any
+from typing import Dict, Any, Final
 import json
 import time
 from collections import OrderedDict
@@ -11,7 +11,7 @@
     gen_ai_attributes as GenAIAttributes
 )
 from agents.tracing.processors import TracingProcessor
-from .utils import dont_throw
+from .utils import dont_throw, should_send_prompts
 
 from traceloop.sdk.tracing import set_agent_name
 
@@ -233,6 +233,7 @@ def on_span_end(self, span):
         if span in self._otel_spans:
             otel_span = self._otel_spans[span]
             span_data = getattr(span, 'span_data', None)
+            should_trace_content: Final[bool] = should_send_prompts()
             if span_data and (
                 type(span_data).__name__ == 'ResponseSpanData' or isinstance(
                     span_data,
@@ -298,7 +299,7 @@ def on_span_end(self, span):
                             otel_span.set_attribute(f"{prefix}.role", role)
 
                         # Set content attribute
-                        if content is not None:
+                        if should_trace_content and content is not None:
                             if not isinstance(content, str):
                                 content = json.dumps(content)
                             otel_span.set_attribute(f"{prefix}.content", content)
@@ -399,7 +400,7 @@ def on_span_end(self, span):
                     if hasattr(response, 'output') and response.output:
                         for i, output in enumerate(response.output):
                             # Handle different output types
-                            if hasattr(output, 'content') and output.content:
+                            if should_trace_content and hasattr(output, 'content') and output.content:
                                 # Text message with content array (ResponseOutputMessage)
                                 content_text = ""
                                 for content_item in output.content:
@@ -430,7 +431,7 @@ def on_span_end(self, span):
                                 otel_span.set_attribute(
                                     f"{GenAIAttributes.GEN_AI_COMPLETION}.{i}.tool_calls.0.id", tool_call_id)
 
-                            elif hasattr(output, 'text'):
+                            elif should_trace_content and hasattr(output, 'text'):
                                 # Direct text content
                                 otel_span.set_attribute(f"{GenAIAttributes.GEN_AI_COMPLETION}.{i}.content", output.text)
                                 otel_span.set_attribute(
@@ -466,7 +467,7 @@ def on_span_end(self, span):
             elif span_data:
                 # Extract prompt data from input and add to response span (legacy support)
                 input_data = getattr(span_data, 'input', [])
-                if input_data:
+                if should_trace_content and input_data:
                     for i, message in enumerate(input_data):
                         if hasattr(message, 'role') and hasattr(message, 'content'):
                             otel_span.set_attribute(f"gen_ai.prompt.{i}.role", message.role)
@@ -508,7 +509,7 @@ def on_span_end(self, span):
                     if hasattr(response, 'output') and response.output:
                         for i, output in enumerate(response.output):
                             # Handle different output types
-                            if hasattr(output, 'content') and output.content:
+                            if should_trace_content and hasattr(output, 'content') and output.content:
                                 # Text message with content array (ResponseOutputMessage)
                                 content_text = ""
                                 for content_item in output.content:
@@ -539,7 +540,7 @@ def on_span_end(self, span):
                                 otel_span.set_attribute(
                                     f"{GenAIAttributes.GEN_AI_COMPLETION}.{i}.tool_calls.0.id", tool_call_id)
 
-                            elif hasattr(output, 'text'):
+                            elif should_trace_content and hasattr(output, 'text'):
                                 # Direct text content
                                 otel_span.set_attribute(f"{GenAIAttributes.GEN_AI_COMPLETION}.{i}.content", output.text)
                                 otel_span.set_attribute(

packages/opentelemetry-instrumentation-openai-agents/opentelemetry/instrumentation/openai_agents/utils.py

@@ -6,6 +6,8 @@
 import traceback
 from opentelemetry import context as context_api
 
+_TRACELOOP_TRACE_CONTENT = "TRACELOOP_TRACE_CONTENT"
+
 
 def set_span_attribute(span, name, value):
     if value is not None:
@@ -18,10 +20,14 @@ def _is_truthy(value):
     return str(value).strip().lower() in ("true", "1", "yes", "on")
 
 
-def should_send_prompts():
-    env_setting = os.getenv("TRACELOOP_TRACE_CONTENT", "true")
+def should_send_prompts() -> bool:
+    """Determine if LLM content tracing should be enabled.
+
+    Content includes not only prompts, but also responses.
+    """
+    env_setting = os.getenv(_TRACELOOP_TRACE_CONTENT, "true")
     override = context_api.get_value("override_enable_content_tracing")
-    return _is_truthy(env_setting) or bool(override)
+    return _is_truthy(env_setting) or _is_truthy(override)
 
 
 class JSONEncoder(json.JSONEncoder):

packages/opentelemetry-instrumentation-openai/opentelemetry/instrumentation/openai/utils.py

@@ -174,10 +174,18 @@ def run_async(method):
         asyncio.run(method)
 
 
-def should_send_prompts():
-    return (
-        os.getenv(TRACELOOP_TRACE_CONTENT) or "true"
-    ).lower() == "true" or context_api.get_value("override_enable_content_tracing")
+def _is_truthy(value):
+    return str(value).strip().lower() in ("true", "1", "yes", "on")
+
+
+def should_send_prompts() -> bool:
+    """Determine if LLM content tracing should be enabled.
+
+    Content includes not only prompts, but also responses.
+    """
+    env_setting = os.getenv(TRACELOOP_TRACE_CONTENT, "true")
+    override = context_api.get_value("override_enable_content_tracing")
+    return _is_truthy(env_setting) or _is_truthy(override)
 
 
 def should_emit_events() -> bool: