Add user tracking to OTLP span attributes + restore guide

- Extract user_id/user_name at top level (available for both Langfuse & OTLP)
- Add enduser.id, user.id, user.name to OTLP span attributes
- Enables user filtering/querying in OTLP traces (via span attributes)
- Keep nice Langfuse SDK traces (generations UI, cost dashboards)

User column won't populate in Langfuse UI (Langfuse doesn't extract from
span attributes), but user info is available in OTLP trace metadata for
custom queries/dashboards/parsing.

Signed-off-by: sallyom <somalley@redhat.com>

Author: sallyom

components/runners/claude-code-runner/wrapper.py

@@ -191,6 +191,10 @@ async def run(self):
     async def _run_claude_agent_sdk(self, prompt: str):
         """Execute the Claude Code SDK with the given prompt."""
         try:
+            # Extract user context for observability (used by both Langfuse and OTLP)
+            user_id = os.getenv('USER_ID', '').strip()
+            user_name = os.getenv('USER_NAME', '').strip()
+
             # Initialize Langfuse for observability if configured
             langfuse_client = None
             langfuse_session_span = None
@@ -204,10 +208,6 @@ async def _run_claude_agent_sdk(self, prompt: str):
                             host=os.getenv('LANGFUSE_HOST')
                         )
 
-                        # Extract user context for observability
-                        user_id = os.getenv('USER_ID', '').strip()
-                        user_name = os.getenv('USER_NAME', '').strip()
-
                         # Start a span for this session (Langfuse SDK 3.x)
                         langfuse_session_span = langfuse_client.start_as_current_span(
                             name="claude_agent_session",
@@ -302,16 +302,28 @@ async def _run_claude_agent_sdk(self, prompt: str):
                         # Get tracer (works whether we just set it or it was already set)
                         otel_tracer = trace.get_tracer(__name__)
 
-                        # Start session span
+                        # Start session span with user tracking
+                        span_attributes = {
+                            "session.id": self.context.session_id,
+                            "namespace": self.context.get_env('AGENTIC_SESSION_NAMESPACE', 'unknown'),
+                            "prompt.length": len(prompt),
+                        }
+
+                        # Add user attributes for custom queries/dashboards
+                        if user_id:
+                            span_attributes["enduser.id"] = user_id  # OpenTelemetry semantic convention
+                            span_attributes["user.id"] = user_id     # Alternative attribute name
+                        if user_name:
+                            span_attributes["user.name"] = user_name
+
                         otel_span = otel_tracer.start_span(
                             "claude_agent_session",
-                            attributes={
-                                "session.id": self.context.session_id,
-                                "namespace": self.context.get_env('AGENTIC_SESSION_NAMESPACE', 'unknown'),
-                                "prompt.length": len(prompt),
-                            }
+                            attributes=span_attributes
                         )
 
+                        if user_id:
+                            logging.info(f"OTLP: User attributes added for {user_name} ({user_id})")
+
                         logging.info(f"OpenTelemetry tracing enabled (endpoint: {otel_endpoint})")
                     except Exception as e:
                         logging.warning(f"Failed to initialize OpenTelemetry: {e}")