aiqa-client 0.4.1__tar.gz → 0.4.7__tar.gz

{aiqa_client-0.4.1/aiqa_client.egg-info → aiqa_client-0.4.7}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: aiqa-client
-Version: 0.4.1
+Version: 0.4.7
 Summary: OpenTelemetry-based Python client for tracing functions and sending traces to the AIQA server
 Author-email: AIQA <info@aiqa.dev>
 License: MIT
-Project-URL: Homepage, https://github.com/winterstein/aiqa
-Project-URL: Documentation, https://github.com/winterstein/aiqa/tree/main/client-python
-Project-URL: Repository, https://github.com/winterstein/aiqa
-Project-URL: Issues, https://github.com/winterstein/aiqa/issues
+Project-URL: Homepage, https://github.com/winterwell/aiqa-client-python
+Project-URL: Documentation, https://github.com/winterwell/aiqa-client-python
+Project-URL: Repository, https://github.com/winterwell/aiqa-client-python
+Project-URL: Issues, https://github.com/winterwell/aiqa-client-python/issues
 Keywords: opentelemetry,tracing,observability,aiqa,monitoring
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
@@ -22,7 +22,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: System :: Monitoring
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
-License-File: LICENSE
+License-File: LICENSE.txt
 Requires-Dist: opentelemetry-api>=1.24.0
 Requires-Dist: opentelemetry-sdk>=1.24.0
 Requires-Dist: opentelemetry-semantic-conventions>=0.40b0

{aiqa_client-0.4.1 → aiqa_client-0.4.7}/aiqa/aiqa_exporter.py

@@ -14,9 +14,11 @@ from typing import List, Dict, Any, Optional
 from opentelemetry.sdk.trace import ReadableSpan
 from opentelemetry.sdk.trace.export import SpanExporter, SpanExportResult
 
-from .constants import AIQA_TRACER_NAME, VERSION
+from .constants import AIQA_TRACER_NAME, VERSION, LOG_TAG
+from .http_utils import get_server_url, get_api_key, build_headers
+from .object_serialiser import toNumber
 
-logger = logging.getLogger("AIQA")
+logger = logging.getLogger(LOG_TAG)
 
 
 class AIQASpanExporter(SpanExporter):
@@ -31,7 +33,8 @@ class AIQASpanExporter(SpanExporter):
         api_key: Optional[str] = None,
         flush_interval_seconds: float = 5.0,
         max_batch_size_bytes: int = 5 * 1024 * 1024,  # 5MB default
-        max_buffer_spans: int = 10000,  # Maximum spans to buffer (prevents unbounded growth)
+        max_buffer_spans: Optional[int] = None,  # Maximum spans to buffer (prevents unbounded growth)
+        max_buffer_size_bytes: Optional[int] = None,  # Maximum buffer size in bytes (prevents unbounded memory growth)
         startup_delay_seconds: Optional[float] = None,
     ):
         """
@@ -42,15 +45,27 @@ class AIQASpanExporter(SpanExporter):
             api_key: API key for authentication (defaults to AIQA_API_KEY env var)
             flush_interval_seconds: How often to flush spans to the server
             max_batch_size_bytes: Maximum size of a single batch in bytes (default: 5mb)
-            max_buffer_spans: Maximum spans to buffer (prevents unbounded growth)
+            max_buffer_spans: Maximum spans to buffer (prevents unbounded growth). 
+                Defaults to 10000, or AIQA_MAX_BUFFER_SPANS env var if set.
+            max_buffer_size_bytes: Maximum total buffer size in bytes (prevents unbounded memory growth).
+                Defaults to None (no limit), or AIQA_MAX_BUFFER_SIZE_BYTES env var if set.
             startup_delay_seconds: Delay before starting auto-flush (default: 10s, or AIQA_STARTUP_DELAY_SECONDS env var)
         """
-        self._server_url = server_url
-        self._api_key = api_key
+        self._server_url = get_server_url(server_url)
+        self._api_key = get_api_key(api_key)
         self.flush_interval_ms = flush_interval_seconds * 1000
         self.max_batch_size_bytes = max_batch_size_bytes
+        
+        # Get max_buffer_spans from parameter, environment variable, or default
+        if not max_buffer_spans:
+            max_buffer_spans = toNumber(os.getenv("AIQA_MAX_BUFFER_SPANS")) or 10000
         self.max_buffer_spans = max_buffer_spans
         
+        # Get max_buffer_size_bytes from parameter, environment variable, or default
+        if not max_buffer_size_bytes:
+            max_buffer_size_bytes = toNumber(os.getenv("AIQA_MAX_BUFFER_SIZE_BYTES")) or toNumber("100m")
+        self.max_buffer_size_bytes = max_buffer_size_bytes
+        
         # Get startup delay from parameter or environment variable (default: 10s)
         if startup_delay_seconds is None:
             env_delay = os.getenv("AIQA_STARTUP_DELAY_SECONDS")
@@ -66,6 +81,11 @@ class AIQASpanExporter(SpanExporter):
         
         self.buffer: List[Dict[str, Any]] = []
         self.buffer_span_keys: set = set()  # Track (traceId, spanId) tuples to prevent duplicates (Python 3.8 compatible)
+        self.buffer_size_bytes: int = 0  # Track total size of buffered spans in bytes
+        # Cache span sizes to avoid recalculation (maps span_key -> size_bytes)
+        # Limited to max_buffer_spans * 2 to prevent unbounded growth
+        self._span_size_cache: Dict[tuple, int] = {}
+        self._max_cache_size = self.max_buffer_spans * 2  # Allow cache to be 2x buffer size
         self.buffer_lock = threading.Lock()
         self.flush_lock = threading.Lock()
         # shutdown_requested is only set once (in shutdown()) and read many times
@@ -75,27 +95,19 @@ class AIQASpanExporter(SpanExporter):
         self._auto_flush_started = False
         self._auto_flush_lock = threading.Lock()  # Lock for lazy thread creation
         
-        logger.info(
-            f"Initializing AIQASpanExporter: server_url={self.server_url or 'not set'}, "
+        logger.info(f"Initializing AIQASpanExporter: server_url={self._server_url or 'not set'}, "
             f"flush_interval={flush_interval_seconds}s, startup_delay={startup_delay_seconds}s"
         )
         # Don't start thread immediately - start lazily on first export to avoid startup issues
 
-    @property
-    def server_url(self) -> str:         
-        return self._server_url or os.getenv("AIQA_SERVER_URL", "").rstrip("/")
-
-    @property
-    def api_key(self) -> str:
-        return self._api_key or os.getenv("AIQA_API_KEY", "")
-
     def export(self, spans: List[ReadableSpan]) -> SpanExportResult:
         """
         Export spans to the AIQA server. Adds spans to buffer for async flushing.
         Deduplicates spans based on (traceId, spanId) to prevent repeated exports.
+        Actual send is done by flush -> _send_spans, or shutdown -> _send_spans_sync
         """
         if not spans:
-            logger.debug("export() called with empty spans list")
+            logger.debug(f"export: called with empty spans list")
             return SpanExportResult.SUCCESS
         
         # Check if AIQA tracing is enabled
@@ -103,13 +115,13 @@ class AIQASpanExporter(SpanExporter):
             from .client import get_aiqa_client
             client = get_aiqa_client()
             if not client.enabled:
-                logger.debug(f"AIQA export() skipped: tracing is disabled")
+                logger.debug(f"AIQA export: skipped: tracing is disabled")
                 return SpanExportResult.SUCCESS
         except Exception:
             # If we can't check enabled status, proceed (fail open)
             pass
         
-        logger.debug(f"AIQA export() called with {len(spans)} spans")
+        logger.debug(f"AIQA export() to buffer called with {len(spans)} spans")
         
         # Lazy initialization: start auto-flush thread on first export
         # This avoids thread creation during initialization, which can cause issues in ECS deployments
@@ -118,40 +130,74 @@ class AIQASpanExporter(SpanExporter):
         # Serialize and add to buffer, deduplicating by (traceId, spanId)
         with self.buffer_lock:
             serialized_spans = []
+            serialized_sizes = []  # Track sizes of serialized spans
             duplicates_count = 0
             dropped_count = 0
+            dropped_memory_count = 0
+            flush_in_progress = self.flush_lock.locked()
+            
             for span in spans:
-                # Check if buffer is full (prevent unbounded growth)
+                # Check if buffer is full by span count (prevent unbounded growth)
                 if len(self.buffer) >= self.max_buffer_spans:
-                    dropped_count += 1
-                    continue
+                    if flush_in_progress:
+                        # Flush in progress, drop this span
+                        dropped_count += 1
+                        continue
+                    # Flush not in progress, will trigger flush after adding spans
+                    # Continue processing remaining spans to add them before flush
                 
                 serialized = self._serialize_span(span)
                 span_key = (serialized["traceId"], serialized["spanId"])
                 if span_key not in self.buffer_span_keys:
+                    # Estimate size of this span when serialized (cache for later use)
+                    span_size = self._get_span_size(span_key, serialized)
+                    
+                    # Check if buffer is full by memory size (prevent unbounded memory growth)
+                    if self.max_buffer_size_bytes is not None and self.buffer_size_bytes + span_size > self.max_buffer_size_bytes:
+                        if flush_in_progress:
+                            # Flush in progress, drop this span
+                            # Don't cache size for dropped spans to prevent memory leak
+                            dropped_memory_count += 1
+                            continue
+                        # Flush not in progress, will trigger flush after adding spans
+                        # Continue processing remaining spans to add them before flush
+                    
                     serialized_spans.append(serialized)
+                    serialized_sizes.append(span_size)
                     self.buffer_span_keys.add(span_key)
                 else:
                     duplicates_count += 1
-                    logger.debug(f"export() skipping duplicate span: traceId={serialized['traceId']}, spanId={serialized['spanId']}")
+                    logger.debug(f"export: skipping duplicate span: traceId={serialized['traceId']}, spanId={serialized['spanId']}")
             
+            # Add spans and update buffer size
             self.buffer.extend(serialized_spans)
+            self.buffer_size_bytes += sum(serialized_sizes)
             buffer_size = len(self.buffer)
             
+            # Check if thresholds are reached after adding spans
+            threshold_reached = self._check_thresholds_reached()
+            
             if dropped_count > 0:
-                logger.warning(
-                    f"WARNING: Buffer full ({buffer_size} spans), dropped {dropped_count} span(s). "
+                logger.warning(f"WARNING: Buffer full ({buffer_size} spans), dropped {dropped_count} span(s) (flush in progress). "
                     f"Consider increasing max_buffer_spans or fixing server connectivity."
                 )
+            if dropped_memory_count > 0:
+                logger.warning(f"WARNING: Buffer memory limit reached ({self.buffer_size_bytes} bytes / {self.max_buffer_size_bytes} bytes), "
+                    f"dropped {dropped_memory_count} span(s) (flush in progress). "
+                    f"Consider increasing AIQA_MAX_BUFFER_SIZE_BYTES or fixing server connectivity."
+                )
+        
+        # Trigger immediate flush if threshold reached and flush not in progress
+        if threshold_reached and not flush_in_progress:
+            logger.info(f"Buffer threshold reached ({buffer_size} spans, {self.buffer_size_bytes} bytes), triggering immediate flush")
+            self._trigger_immediate_flush()
         
         if duplicates_count > 0:
-            logger.debug(
-                f"export() added {len(serialized_spans)} span(s) to buffer, skipped {duplicates_count} duplicate(s). "
+            logger.debug(f"export() added {len(serialized_spans)} span(s) to buffer, skipped {duplicates_count} duplicate(s). "
                 f"Total buffered: {buffer_size}"
             )
         else:
-            logger.debug(
-                f"export() added {len(spans)} span(s) to buffer. "
+            logger.debug(f"export() added {len(spans)} span(s) to buffer. "
                 f"Total buffered: {buffer_size}"
             )
 
@@ -233,18 +279,35 @@ class AIQASpanExporter(SpanExporter):
         nanos = int(nanoseconds % 1_000_000_000)
         return (seconds, nanos)
 
+    def _get_span_size(self, span_key: tuple, serialized: Dict[str, Any]) -> int:
+        """
+        Get span size from cache or calculate and cache it.
+        Thread-safe when called within buffer_lock.
+        Limits cache size to prevent unbounded memory growth.
+        """
+        if span_key in self._span_size_cache:
+            return self._span_size_cache[span_key]
+        span_json = json.dumps(serialized)
+        span_size = len(span_json.encode('utf-8'))
+        # Only cache if we have valid keys and cache isn't too large
+        if span_key[0] and span_key[1] and len(self._span_size_cache) < self._max_cache_size:
+            self._span_size_cache[span_key] = span_size
+        return span_size
+
+    def _check_thresholds_reached(self) -> bool:
+        """Check if buffer thresholds are reached. Must be called within buffer_lock."""
+        if len(self.buffer) >= self.max_buffer_spans:
+            return True
+        if self.max_buffer_size_bytes is not None and self.buffer_size_bytes >= self.max_buffer_size_bytes:
+            return True
+        return False
+
     def _build_request_headers(self) -> Dict[str, str]:
         """Build HTTP headers for span requests."""
-        headers = {"Content-Type": "application/json"}
-        if self.api_key:
-            headers["Authorization"] = f"ApiKey {self.api_key}"
-        return headers
+        return build_headers(self._api_key)
 
     def _get_span_url(self) -> str:
-        """Get the URL for sending spans."""
-        if not self.server_url:
-            raise ValueError("AIQA_SERVER_URL is not set. Cannot send spans to server.")
-        return f"{self.server_url}/span"
+        return f"{self._server_url}/span"
 
     def _is_interpreter_shutdown_error(self, error: Exception) -> bool:
         """Check if error is due to interpreter shutdown."""
@@ -263,36 +326,49 @@ class AIQASpanExporter(SpanExporter):
         are added between extraction and clearing.
         Note: Does NOT clear buffer_span_keys - that should be done after successful send
         to avoid unnecessary clearing/rebuilding on failures.
+        Also resets buffer_size_bytes to 0.
         """
         with self.buffer_lock:
             spans = self.buffer[:]
             self.buffer.clear()
+            self.buffer_size_bytes = 0
             return spans
     
     def _remove_span_keys_from_tracking(self, spans: List[Dict[str, Any]]) -> None:
         """
-        Remove span keys from tracking set (thread-safe). Called after successful send.
+        Remove span keys from tracking set and size cache (thread-safe). Called after successful send.
         """
         with self.buffer_lock:
             for span in spans:
                 span_key = (span["traceId"], span["spanId"])
                 self.buffer_span_keys.discard(span_key)
+                # Also remove from size cache to free memory
+                self._span_size_cache.pop(span_key, None)
 
     def _prepend_spans_to_buffer(self, spans: List[Dict[str, Any]]) -> None:
         """
         Prepend spans back to buffer (thread-safe). Used to restore spans
-        if sending fails. Rebuilds the span keys tracking set.
+        if sending fails. Rebuilds the span keys tracking set and buffer size.
+        Uses cached sizes when available to avoid re-serialization.
         """
         with self.buffer_lock:
             self.buffer[:0] = spans
             # Rebuild span keys set from current buffer contents
             self.buffer_span_keys = {(span["traceId"], span["spanId"]) for span in self.buffer}
+            # Recalculate buffer size using cache when available
+            total_size = 0
+            for span in self.buffer:
+                span_key = (span.get("traceId"), span.get("spanId"))
+                total_size += self._get_span_size(span_key, span)
+            self.buffer_size_bytes = total_size
 
     def _clear_buffer(self) -> None:
         """Clear the buffer (thread-safe)."""
         with self.buffer_lock:
             self.buffer.clear()
             self.buffer_span_keys.clear()
+            self.buffer_size_bytes = 0
+            self._span_size_cache.clear()
 
     def _split_into_batches(self, spans: List[Dict[str, Any]]) -> List[List[Dict[str, Any]]]:
         """
@@ -308,9 +384,9 @@ class AIQASpanExporter(SpanExporter):
         current_batch_size = 0
         
         for span in spans:
-            # Estimate size of this span when serialized
-            span_json = json.dumps(span)
-            span_size = len(span_json.encode('utf-8'))
+            # Get size from cache if available, otherwise calculate it
+            span_key = (span.get("traceId"), span.get("spanId"))
+            span_size = self._get_span_size(span_key, span)
             
             # Check if this single span exceeds the limit
             if span_size > self.max_batch_size_bytes:
@@ -323,8 +399,7 @@ class AIQASpanExporter(SpanExporter):
                 # Log warning about oversized span
                 span_name = span.get('name', 'unknown')
                 span_trace_id = span.get('traceId', 'unknown')
-                logger.warning(
-                    f"Span '{span_name}' (traceId={span_trace_id}) exceeds max_batch_size_bytes "
+                logger.warning(f"Span \'{span_name}' (traceId={span_trace_id}) exceeds max_batch_size_bytes "
                     f"({span_size} bytes > {self.max_batch_size_bytes} bytes). "
                     f"Will attempt to send it anyway - may fail if server/nginx limit is exceeded."
                 )
@@ -354,22 +429,21 @@ class AIQASpanExporter(SpanExporter):
         
         Lock ordering: flush_lock -> buffer_lock (must be consistent to avoid deadlocks)
         """
-        logger.debug("flush() called - attempting to acquire flush lock")
+        logger.debug(f"flush: called - attempting to acquire flush lock")
         with self.flush_lock:
-            logger.debug("flush() acquired flush lock")
+            logger.debug(f"flush() acquired flush lock")
             # Atomically extract and remove spans to prevent race conditions
             # where export() adds spans between extraction and clearing
             spans_to_flush = self._extract_and_remove_spans_from_buffer()
-            logger.debug(f"flush() extracted {len(spans_to_flush)} span(s) from buffer")
+            logger.debug(f"flush: extracted {len(spans_to_flush)} span(s) from buffer")
 
             if not spans_to_flush:
-                logger.debug("flush() completed: no spans to flush")
+                logger.debug(f"flush() completed: no spans to flush")
                 return
 
             # Skip sending if server URL is not configured
-            if not self.server_url:
-                logger.warning(
-                    f"Skipping flush: AIQA_SERVER_URL is not set. {len(spans_to_flush)} span(s) will not be sent."
+            if not self._server_url:
+                logger.warning(f"Skipping flush: AIQA_SERVER_URL is not set. {len(spans_to_flush)} span(s) will not be sent."
                 )
                 # Spans already removed from buffer, clear their keys to free memory
                 self._remove_span_keys_from_tracking(spans_to_flush)
@@ -377,7 +451,7 @@ class AIQASpanExporter(SpanExporter):
 
         # Release flush_lock before I/O to avoid blocking other flush attempts
         # Spans are already extracted, so concurrent exports won't interfere
-        logger.info(f"flush() sending {len(spans_to_flush)} span(s) to server")
+        logger.info(f"flush: sending {len(spans_to_flush)} span(s) to server")
         try:
             await self._send_spans(spans_to_flush)
             logger.info(f"flush() successfully sent {len(spans_to_flush)} span(s) to server")
@@ -387,7 +461,7 @@ class AIQASpanExporter(SpanExporter):
         except RuntimeError as error:
             if self._is_interpreter_shutdown_error(error):
                 if self.shutdown_requested:
-                    logger.debug(f"flush() skipped due to interpreter shutdown: {error}")
+                    logger.debug(f"flush: skipped due to interpreter shutdown: {error}")
                 else:
                     logger.warning(f"flush() interrupted by interpreter shutdown: {error}")
                 # Put spans back for retry with sync send during shutdown
@@ -423,10 +497,32 @@ class AIQASpanExporter(SpanExporter):
                 # Don't raise - allow spans to be buffered even if auto-flush fails
                 # They can still be flushed manually or on shutdown
 
+    def _trigger_immediate_flush(self) -> None:
+        """
+        Trigger an immediate flush in a background thread.
+        This is called when buffer thresholds are reached and no flush is in progress.
+        """
+        def flush_in_thread():
+            """Run flush in a new thread with its own event loop."""
+            try:
+                loop = asyncio.new_event_loop()
+                asyncio.set_event_loop(loop)
+                try:
+                    loop.run_until_complete(self.flush())
+                finally:
+                    if not loop.is_closed():
+                        loop.close()
+            except Exception as e:
+                logger.error(f"Error in immediate flush thread: {e}", exc_info=True)
+        
+        # Start flush in background thread (daemon so it doesn't block shutdown)
+        flush_thread = threading.Thread(target=flush_in_thread, daemon=True, name="AIQA-ImmediateFlush")
+        flush_thread.start()
+
     def _flush_worker(self) -> None:
         """Worker function for auto-flush thread. Runs in a separate thread with its own event loop."""
         import asyncio
-        logger.debug("Auto-flush worker thread started")
+        logger.debug(f"Auto-flush worker thread started")
         
         # Wait for startup delay before beginning flush operations
         # This gives the container/application time to stabilize, which helps avoid startup issues (seen with AWS ECS, Dec 2025).
@@ -441,10 +537,10 @@ class AIQASpanExporter(SpanExporter):
                 remaining_delay -= sleep_time
             
             if self.shutdown_requested:
-                logger.debug("Auto-flush startup delay interrupted by shutdown")
+                logger.debug(f"Auto-flush startup delay interrupted by shutdown")
                 return
             
-            logger.info("Auto-flush startup delay complete, beginning flush operations")
+            logger.info(f"Auto-flush startup delay complete, beginning flush operations")
         
         # Create event loop in this thread (isolated from main thread's event loop)
         # This prevents interference with the main application's event loop
@@ -475,24 +571,23 @@ class AIQASpanExporter(SpanExporter):
             logger.info(f"Auto-flush worker thread stopping (shutdown requested). Completed {cycle_count} cycles.")
             # Don't do final flush here - shutdown() will handle it with synchronous send
             # This avoids event loop shutdown issues
-            logger.debug("Auto-flush thread skipping final flush (will be handled by shutdown() with sync send)")
+            logger.debug(f"Auto-flush thread skipping final flush (will be handled by shutdown() with sync send)")
         finally:
             # Always close the event loop, even if an exception occurs
             try:
                 if not loop.is_closed():
                     loop.close()
-                logger.debug("Auto-flush worker thread event loop closed")
+                logger.debug(f"Auto-flush worker thread event loop closed")
             except Exception:
                 pass  # Ignore errors during cleanup
     
     def _start_auto_flush(self) -> None:
         """Start the auto-flush timer with startup delay."""
         if self.shutdown_requested:
-            logger.warning("_start_auto_flush() called but shutdown already requested")
+            logger.warning(f"_start_auto_flush() called but shutdown already requested")
             return
 
-        logger.info(
-            f"Starting auto-flush thread with interval {self.flush_interval_ms / 1000.0}s, "
+        logger.info(f"Starting auto-flush thread with interval {self.flush_interval_ms / 1000.0}s, "
             f"startup delay {self.startup_delay_seconds}s"
         )
 
@@ -508,15 +603,15 @@ class AIQASpanExporter(SpanExporter):
         # Split into batches if needed
         batches = self._split_into_batches(spans)
         if len(batches) > 1:
-            logger.info(f"_send_spans() splitting {len(spans)} spans into {len(batches)} batches")
+            logger.info(f"_send_spans: splitting {len(spans)} spans into {len(batches)} batches")
         
         url = self._get_span_url()
         headers = self._build_request_headers()
         
-        if self.api_key:
-            logger.debug("_send_spans() using API key authentication")
-        else:
-            logger.debug("_send_spans() no API key provided")
+        if not self._api_key: # This should not happen
+            logger.error(f"_send_spans: fail - no API key provided. {len(spans)} spans lost.")
+            # Spans were already removed from buffer before calling this method. They will now get forgotten
+            return
 
         # Use timeout to prevent hanging on unreachable servers
         timeout = aiohttp.ClientTimeout(total=30.0, connect=10.0)
@@ -524,41 +619,41 @@ class AIQASpanExporter(SpanExporter):
         async with aiohttp.ClientSession(timeout=timeout) as session:
             for batch_idx, batch in enumerate(batches):
                 try:
-                    logger.debug(f"_send_spans() sending batch {batch_idx + 1}/{len(batches)} with {len(batch)} spans to {url}")
+                    logger.debug(f"_send_spans: sending batch {batch_idx + 1}/{len(batches)} with {len(batch)} spans to {url}")
                     # Pre-serialize JSON to bytes and wrap in BytesIO to avoid blocking event loop
                     json_bytes = json.dumps(batch).encode('utf-8')
                     data = io.BytesIO(json_bytes)
                     
                     async with session.post(url, data=data, headers=headers) as response:
-                        logger.debug(f"_send_spans() batch {batch_idx + 1} received response: status={response.status}")
+                        logger.debug(f"_send_spans: batch {batch_idx + 1} received response: status={response.status}")
                         if not response.ok:
                             error_text = await response.text()
                             error_msg = f"Failed to send batch {batch_idx + 1}/{len(batches)}: {response.status} {response.reason} - {error_text[:200]}"
-                            logger.error(f"_send_spans() {error_msg}")
+                            logger.error(f"_send_spans: {error_msg}")
                             errors.append((batch_idx + 1, error_msg))
                             # Continue with other batches even if one fails
                             continue
-                        logger.debug(f"_send_spans() batch {batch_idx + 1} successfully sent {len(batch)} spans")
+                        logger.debug(f"_send_spans: batch {batch_idx + 1} successfully sent {len(batch)} spans")
                 except (aiohttp.ClientError, asyncio.TimeoutError) as e:
                     # Network errors and timeouts - log but don't fail completely
                     error_msg = f"Network error in batch {batch_idx + 1}: {type(e).__name__}: {e}"
-                    logger.warning(f"_send_spans() {error_msg} - will retry on next flush")
+                    logger.warning(f"_send_spans: {error_msg} - will retry on next flush")
                     errors.append((batch_idx + 1, error_msg))
                     # Continue with other batches
                 except RuntimeError as e:
                     if self._is_interpreter_shutdown_error(e):
                         if self.shutdown_requested:
-                            logger.debug(f"_send_spans() skipped due to interpreter shutdown: {e}")
+                            logger.debug(f"_send_spans: skipped due to interpreter shutdown: {e}")
                         else:
-                            logger.warning(f"_send_spans() interrupted by interpreter shutdown: {e}")
+                            logger.warning(f"_send_spans: interrupted by interpreter shutdown: {e}")
                         raise
                     error_msg = f"RuntimeError in batch {batch_idx + 1}: {type(e).__name__}: {e}"
-                    logger.error(f"_send_spans() {error_msg}")
+                    logger.error(f"_send_spans: {error_msg}")
                     errors.append((batch_idx + 1, error_msg))
                     # Continue with other batches
                 except Exception as e:
                     error_msg = f"Exception in batch {batch_idx + 1}: {type(e).__name__}: {e}"
-                    logger.error(f"_send_spans() {error_msg}")
+                    logger.error(f"_send_spans: {error_msg}")
                     errors.append((batch_idx + 1, error_msg))
                     # Continue with other batches
         
@@ -568,7 +663,7 @@ class AIQASpanExporter(SpanExporter):
             error_summary = "; ".join([f"batch {idx}: {msg}" for idx, msg in errors])
             raise Exception(f"Failed to send some spans: {error_summary}")
         
-        logger.debug(f"_send_spans() successfully sent all {len(spans)} spans in {len(batches)} batch(es)")
+        logger.debug(f"_send_spans: successfully sent all {len(spans)} spans in {len(batches)} batch(es)")
 
     def _send_spans_sync(self, spans: List[Dict[str, Any]]) -> None:
         """Send spans to the server API (synchronous, for shutdown scenarios). Batches large payloads automatically."""
@@ -582,10 +677,9 @@ class AIQASpanExporter(SpanExporter):
         url = self._get_span_url()
         headers = self._build_request_headers()
         
-        if self.api_key:
-            logger.debug("_send_spans_sync() using API key authentication")
-        else:
-            logger.debug("_send_spans_sync() no API key provided")
+        if not self._api_key:
+            logger.error(f"_send_spans_sync() fail - no API key provided")
+            return
 
         errors = []
         for batch_idx, batch in enumerate(batches):
@@ -616,64 +710,63 @@ class AIQASpanExporter(SpanExporter):
 
     def shutdown(self) -> None:
         """Shutdown the exporter, flushing any remaining spans. Call before process exit."""
-        logger.info("shutdown() called - initiating exporter shutdown")
+        logger.info(f"shutdown: called - initiating exporter shutdown")
         self.shutdown_requested = True
 
         # Check buffer state before shutdown
         with self.buffer_lock:
             buffer_size = len(self.buffer)
-            logger.info(f"shutdown() buffer contains {buffer_size} span(s) before shutdown")
+            logger.info(f"shutdown: buffer contains {buffer_size} span(s) before shutdown")
 
         # Wait for flush thread to finish (it will do final flush)
         # Only wait if thread was actually started
         if self._auto_flush_started and self.flush_timer and self.flush_timer.is_alive():
-            logger.info("shutdown() waiting for auto-flush thread to complete (timeout=10s)")
+            logger.info(f"shutdown: waiting for auto-flush thread to complete (timeout=10s)")
             self.flush_timer.join(timeout=10.0)
             if self.flush_timer.is_alive():
-                logger.warning("shutdown() auto-flush thread did not complete within timeout")
+                logger.warning(f"shutdown: auto-flush thread did not complete within timeout")
             else:
-                logger.info("shutdown() auto-flush thread completed")
+                logger.info(f"shutdown: auto-flush thread completed")
         else:
-            logger.debug("shutdown() no active auto-flush thread to wait for")
+            logger.debug(f"shutdown: no active auto-flush thread to wait for")
 
         # Final flush attempt (use synchronous send to avoid event loop issues)
         with self.flush_lock:
-            logger.debug("shutdown() performing final flush with synchronous send")
+            logger.debug(f"shutdown: performing final flush with synchronous send")
             # Atomically extract and remove spans to prevent race conditions
             spans_to_flush = self._extract_and_remove_spans_from_buffer()
-            logger.debug(f"shutdown() extracted {len(spans_to_flush)} span(s) from buffer for final flush")
+            logger.debug(f"shutdown: extracted {len(spans_to_flush)} span(s) from buffer for final flush")
 
             if spans_to_flush:
-                if not self.server_url:
-                    logger.warning(
-                        f"shutdown() skipping final flush: AIQA_SERVER_URL is not set. "
+                if not self._server_url:
+                    logger.warning(f"shutdown: skipping final flush: AIQA_SERVER_URL is not set. "
                         f"{len(spans_to_flush)} span(s) will not be sent."
                     )
                     # Spans already removed from buffer, clear their keys to free memory
                     self._remove_span_keys_from_tracking(spans_to_flush)
                 else:
-                    logger.info(f"shutdown() sending {len(spans_to_flush)} span(s) to server (synchronous)")
+                    logger.info(f"shutdown: sending {len(spans_to_flush)} span(s) to server (synchronous)")
                     try:
                         self._send_spans_sync(spans_to_flush)
-                        logger.info(f"shutdown() successfully sent {len(spans_to_flush)} span(s) to server")
+                        logger.info(f"shutdown: successfully sent {len(spans_to_flush)} span(s) to server")
                         # Spans already removed from buffer during extraction
                         # Clear their keys from tracking set to free memory
                         self._remove_span_keys_from_tracking(spans_to_flush)
                     except Exception as e:
-                        logger.error(f"shutdown() failed to send spans: {e}")
+                        logger.error(f"shutdown: failed to send spans: {e}")
                         # Spans already removed, but process is exiting anyway
-                        logger.warning(f"shutdown() {len(spans_to_flush)} span(s) were not sent due to error")
+                        logger.warning(f"shutdown: {len(spans_to_flush)} span(s) were not sent due to error")
                         # Keys will remain in tracking set, but process is exiting so memory will be freed
             else:
-                logger.debug("shutdown() no spans to flush")
+                logger.debug(f"shutdown: no spans to flush")
         
         # Check buffer state after shutdown
         with self.buffer_lock:
             buffer_size = len(self.buffer)
             if buffer_size > 0:
-                logger.warning(f"shutdown() buffer still contains {buffer_size} span(s) after shutdown")
+                logger.warning(f"shutdown: buffer still contains {buffer_size} span(s) after shutdown")
             else:
-                logger.info("shutdown() buffer is empty after shutdown")
+                logger.info(f"shutdown: buffer is empty after shutdown")
         
-        logger.info("shutdown() completed")
+        logger.info(f"shutdown: completed")